📚 Wiki MCP Server

📚 Wiki MCP 服务

用于管理 Confluence Wiki 页面的 MCP（模型上下文协议）服务实现。

支持：

• 创建新的 Wiki 页面
• 更新现有 Wiki 页面
• 删除 Wiki 页面
• 按关键词搜索 Wiki 页面
• 根据用户查询自动选择正确的 Confluence 知识库（alm、wpb 等）

基于 FastAPI 构建，遵循 MCP 服务最佳实践，可用于生产部署。

---

🚀 技术栈

• Python 3.10+
• FastAPI
• MCP SDK
• Requests（用于与 Confluence API 交互）
• ContextVars（用于会话管理）

---

📦 项目结构

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

---

⚙️ 安装

1. 克隆仓库：

git clone https://your-repo-url/wiki_mcp_server.git
cd wiki_mcp_server

2. 安装依赖：

pip install -r requirements.txt

3. （可选）根据需要配置环境变量。

---

🛠 本地运行

运行服务：

cd src
uvicorn wiki_mcp_server.server:app --host 0.0.0.0 --port 9999 --reload

启动后，可访问：

• OpenAPI 文档（Swagger UI）：http://localhost:9999/docs
• ReDoc 文档：http://localhost:9999/redoc

---

🧪 请求示例

必需的请求头：

键	示例值
user_name	[email protected]
alm_confluence_base_url	https://your-confluence-site/wiki/rest/api
alm_confluence_api_token	your-api-token
wpb_confluence_base_url	（如果可用则为可选项）
wpb_confluence_api_token	（如果可用则为可选项）

⚠️ 如果缺少请求头或请求头无效，服务将返回 HTTP 400 错误。

---

示例：创建页面

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."
}

行为：

• 服务将根据 user_query 推断 wiki_type=alm。
• 在 Confluence 中创建页面并返回页面元数据。

---

🧠 自动推断逻辑

• 如果查询中提到 gsna、global、alm-confluence → alm
• 如果查询中提到 wpb、wealth → wpb
• 否则默认为 alm

（也可以在输入中手动指定 wiki_type）

---

🐳 Docker（可选）

构建并运行容器化服务：

docker build -t wiki-mcp-server .
docker run -d -p 9999:9999 --name wiki-mcp-server wiki-mcp-server

---

📜 许可证

MIT 许可证。

---

📞 联系方式

如有问题或合作需求，请联系：

• 开发者：Shawn
• 电子邮件：[email protected]
• 项目由内部 MCP 工作组维护

---# wiki_mcp_server