🚀 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
手动安装
- 克隆仓库：
git clone https://github.com/yourusername/confluence-mcp.git
cd confluence-mcp
- 安装依赖项：
pip install -r requirements.txt
- 启动服务器：
python server.py
🛠️ 配置
- 创建
.env文件并添加以下内容：
CONFLUENCE_BASE_URL=your_confluence_url
USERNAME=your_atlassian_email
API_TOKEN=your_api_token
- 环境变量示例：
export CONFLUENCE_BASE_URL="https://yourcompany.atlassian.net/wiki"
export USERNAME="user@example.com"
export API_TOKEN="your_api_token_here"
💻 使用示例
基础用法
- 启动服务器：
python server.py
- 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 |
超出速率限制 |
故障排除
- 连接问题：
- 验证 CONFLUENCE_BASE_URL 格式。
- 检查网络连通性。
- 确认 API 令牌有效。
- 身份验证错误：
- 确保 USERNAME 匹配 Atlassian 账户邮箱。
- 验证 API_TOKEN 正确粘贴。
- 检查 .env 文件中的特殊字符。
- 权限问题：
- 确认用户具有所需的 Confluence 权限。
- 验证空间和页面访问权限。
支持
如需报告问题或功能请求，请在仓库的问题跟踪器中创建问题。
📄 许可证
本项目采用 MIT License。详见 LICENSE 文件以获取完整条款。