Confluence MCP 服务器

一个基于 FastMCP 的服务器，提供与 Confluence REST API 的无缝集成，实现对 Confluence 空间、页面和内容搜索功能的程序化访问。

关键特性

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

系统要求

• Python 3.8+
• pip（Python 包管理器）
• 带有 API 访问的有效 Confluence 实例
• 有效 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
   
   

配置

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"
   
   

使用指南

1. 启动服务器：

   python server.py
   

2. API 方法示例：
   • 获取空间列表：

     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)
     
     

集成

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 文件以获取完整条款。