π Wiki MCP Server
About
An MCP (Model Context Protocol) server implementation for managing Confluence wiki pages. It provides tools to create, update, delete, and search pages, with automatic selection of the correct Confluence knowledge base based on user queries. Built for developers and teams usingβ¦
Details
- Author
- MCP-Mirror
- Downloads
- 280
- Categories
- Knowledge Base
Jump to
- Create new Confluence wiki pages.
- Update existing wiki pages.
- Delete wiki pages by identifier.
- Search wiki pages by keyword.
- Autoβselect knowledge base (e.g., alm, wpb) from query context.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
π Wiki MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, install dependencies with pip install -r requirements.txt, then run uvicorn wiki_mcp_server.server:app --host 0.0.0.0 --port 9999 --reload. Every request must include HTTP headers for authentication: user_name, alm_confluence_base_url, alm_confluence_api_token (and optionally wpb_confluence_base_url and wpb_confluence_api_token). Use the provided REST endpoints such as /create_page with a JSON body containing space_key, title, content, and user_query.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83d\udcda wiki mcp server": {
"albertshao_wiki_mcp_server": {
"command": "docker",
"args": [
"build",
"-t",
"wiki-mcp-server",
"."
]
}
}
}
}McpServers
{
"albertshao_wiki_mcp_server": {
"command": "docker",
"args": [
"build",
"-t",
"wiki-mcp-server",
"."
]
}
}π Wiki MCP Server
An MCP (Model Context Protocol) Server implementation for managing Confluence wiki pages.
Supports:
- Creating new wiki pages
- Updating existing wiki pages
- Deleting wiki pages
- Searching wiki pages by keyword
- Auto-selecting correct Confluence knowledge base (alm, wpb, etc.) based on user query
Built with FastAPI, following MCP Server Best Practices, and ready for production deployment.
---
π Tech Stack
- Python 3.10+
- FastAPI
- MCP SDK
- Requests (for Confluence API interaction)
- ContextVars (for session management)
---
π¦ Project Structure
wiki_mcp_server/
βββ src/wiki_mcp_server/
β βββ server.py # MCP server entry point
β βββ service.py # Business logic (Confluence API interactions)
β βββ tools.py # MCP tool definitions
β βββ prompts.py # MCP prompt definitions
β βββ resources.py # MCP resource definitions
β βββ utils.py # Helper functions (wiki_type inference etc.)
β βββ utils/session_context.py # Session context manager
β βββ middleware.py # Authentication and session initialization middleware
βββ Dockerfile # Container configuration
βββ requirements.txt # Python dependencies
βββ README.md # Project documentation
βββ smithery.yaml # Smithery integration config (optional)
βββ pyproject.toml # Python project metadata
---
βοΈ Installation
1. Clone the repository:
git clone https://your-repo-url/wiki_mcp_server.git
cd wiki_mcp_server
2. Install dependencies:
pip install -r requirements.txt
3. (Optional) Configure your environment variables if needed.
---
π Running Locally
Run the server:
cd src
uvicorn wiki_mcp_server.server:app --host 0.0.0.0 --port 9999 --reload
After startup, you can visit:
- OpenAPI docs (Swagger UI): http://localhost:9999/docs
- ReDoc docs: http://localhost:9999/redoc
---
π§ͺ Example Request
Headers Required:
| Key | Example Value |
|:---|:---|
| user_name | john.doe@domain.com |
| alm_confluence_base_url | https://your-confluence-site/wiki/rest/api |
| alm_confluence_api_token | your-api-token |
| wpb_confluence_base_url | (optional if available) |
| wpb_confluence_api_token | (optional if available) |
> β οΈ If headers are missing or invalid, server will return HTTP 400 error.
---
Example: Create Page
POST /create_page
{
"space_key": "TEST",
"title": "Test Page Created by MCP Server",
"content": "<p>Hello, World!</p>",
"user_query": "Please create a page in GSNA knowledge base."
}
Behavior:
- Server will infer wiki_type=alm from user_query.
- Create the page in Confluence and return page metadata.
---
π§ Auto Inference Logic
- If the query mentions gsna, global, alm-confluence β alm
- If the query mentions wpb, wealth β wpb
- Otherwise default to alm
(You can also manually specify wiki_type in input)
---
π³ Docker (Optional)
Build and run containerized server:
docker build -t wiki-mcp-server .
docker run -d -p 9999:9999 --name wiki-mcp-server wiki-mcp-server
---
π License
MIT License.
---
π Contact
For issues or collaboration requests, please contact:
- Developer: Shawn
- Email: gsqasxb@gmail.com
- Project maintained by internal MCP Working Group
---# wiki_mcp_server
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
