HelloWorld
登录
W

Wiki MCP 智能服务器

一种MCP服务器实现，它通过自然语言查询来管理Confluence维基页面，支持在不同知识库中创建、更新、删除和搜索页面等操作。

content-management-systemsother

618 查看 · 2026-07-07 更新

简介

一种MCP服务器实现，它通过自然语言查询来管理Confluence维基页面，支持在不同知识库中创建、更新、删除和搜索页面等操作。

简介

一种MCP服务器实现，它通过自然语言查询来管理Confluence维基页面，支持在不同知识库中创建、更新、删除和搜索页面等操作。

📚 Wiki MCP 服务器

一个用于管理 Confluence 维基页面的 MCP（Model Context Protocol）服务器实现。

支持：

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

使用 FastAPI 构建，遵循 MCP 服务器最佳实践，并准备好进行生产部署。

🚀 技术栈

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

📦 项目结构

plaintext wiki_mcp_server/ ├── src/wiki_mcp_server/ │ ├── server.py # MCP 服务器入口点 │ ├── service.py # 业务逻辑 (Confluence API 交互) │ ├── tools.py # MCP 工具定义 │ ├── prompts.py # MCP 提示定义 │ ├── resources.py # MCP 资源定义 │ ├── utils.py # 辅助函数 (如 wiki_type 推断等) │ ├── utils/session_context.py # 会话上下文管理器 │ └── middleware.py # 认证和会话初始化中间件 ├── Dockerfile # 容器配置 ├── requirements.txt # Python 依赖项 ├── README.md # 项目文档 ├── smithery.yaml # Smithery 集成配置 (可选) └── pyproject.toml # Python 项目元数据

⚙️ 安装

  1. 克隆仓库：

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

  1. 安装依赖项：

bash pip install -r requirements.txt

  1. (可选) 如果需要，请配置环境变量。

🛠 本地运行

运行服务器：

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

启动后，您可以访问：

🧪 示例请求

所需头部信息：

键示例值
user_namejohn.doe@domain.com
alm_confluence_base_urlhttps://your-confluence-site/wiki/rest/api
alm_confluence_api_tokenyour-api-token
wpb_confluence_base_url(如果可用则为可选)
wpb_confluence_api_token(如果可用则为可选)

⚠️ 如果缺少或无效的头部信息，服务器将返回 HTTP 400 错误。

示例：创建页面

POST /create_page

json { "space_key": "TEST", "title": "Test Page Created by MCP Server", "content": "

Hello, World!

", "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 (可选)

构建并运行容器化的服务器：

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

📜 许可证

MIT 许可证。

📞 联系方式

对于问题或合作请求，请联系：

来源