🚀 Confluence MCP 服务器

Confluence MCP 服务器是一个基于 FastMCP 的服务器，它能与 Confluence REST API 实现无缝集成，可让用户以程序化的方式访问 Confluence 空间、页面以及使用内容搜索功能。

🚀 快速开始

Confluence MCP 服务器可帮助你便捷地管理 Confluence 空间和页面。你只需按照以下步骤操作，即可快速搭建并使用该服务器。

✨ 主要特性

• 空间管理：可以列出并筛选 Confluence 空间。
• 页面操作：能够检索和管理页面内容。
• 搜索功能：支持执行 CQL（Confluence 查询语言）搜索。
• 空间导航：可列出特定空间中的所有页面。
• 身份验证：采用基于 API 令牌的安全访问方式。

📦 安装指南

使用 Smithery 自动安装

通过 Smithery 为 Claude Desktop 自动安装 confluence-mcp-server：

npx -y @smithery/cli install @MahithChigurupati/confluence-mcp-server --client claude

手动安装

1. 克隆仓库：

git clone https://github.com/yourusername/confluence-mcp.git
cd confluence-mcp

2. 安装依赖项：

pip install -r requirements.txt

3. 启动服务器：

python server.py

💻 使用示例

基础用法

启动服务器

python server.py

获取空间列表

response = requests.get("http://localhost:5000/api/confluence/spaces")

创建新页面

data = {
    "title": "New Page",
    "parent_id": "12345"
}
response = requests.post("http://localhost:5000/api/confluence/pages", json=data)

📚 详细文档

配置

1. 创建 .env 文件并添加以下内容：

CONFLUENCE_BASE_URL=your_confluence_url
USERNAME=your_atlassian_email
API_TOKEN=your_api_token

2. 环境变量示例：

export CONFLUENCE_BASE_URL="https://yourcompany.atlassian.net/wiki"
export USERNAME="user@example.com"
export API_TOKEN="your_api_token_here"

集成

Claude Desktop 配置示例：

{
    "server_url": "http://localhost:5000",
    "api_key": "your_api_key_here"
}

Cursor 配置示例：

{
    "confluence_server": "https://yourcompany.atlassian.net/wiki",
    "username": "user@example.com",
    "api_token": "your_api_token_here"
}

错误处理

常见错误代码及其含义：

• 401：无效的 API 令牌或凭据。
• 403：权限不足。
• 404：资源未找到。
• 429：超出速率限制。

故障排除

1. 连接问题：
   • 验证 CONFLUENCE_BASE_URL 格式。
   • 检查网络连通性。
   • 确认 API 令牌有效。
2. 身份验证错误：
   • 确保 USERNAME 匹配 Atlassian 账户邮箱。
   • 验证 API_TOKEN 正确粘贴。
   • 检查 .env 文件中的特殊字符。
3. 权限问题：
   • 确认用户具有所需的 Confluence 权限。
   • 验证空间和页面访问权限。

📄 许可证

本项目采用 MIT License。详见 LICENSE 文件以获取完整条款。

支持

如需报告问题或功能请求，请在仓库的问题跟踪器中创建问题。

系统要求

• Python 3.8+
• pip（Python 包管理器）
• 带有 API 访问的有效 Confluence 实例
• 有效 Confluence API 令牌