Confluence MCP Server
2025.04.08
0
PythonConfluence 集成文档管理API 服务交流协作
Confluence-MCP-Server 是一个基于 FastMCP 的服务，提供与 Confluence REST API 的无缝集成，支持对 Confluence 空间、页面和内容搜索功能的程序化访问。
View on GitHub
Overview
基本能力
产品定位
Confluence-MCP-Server 是一个中间件服务，旨在为开发人员提供程序化访问 Confluence 内容的能力，简化与 Confluence 的集成过程。
核心功能
- 空间管理：列出和筛选 Confluence 空间
- 页面操作：检索和管理页面内容
- 搜索功能：执行 CQL (Confluence Query Language) 搜索
- 空间导航：列出特定空间内的所有页面
- 认证：基于 API 令牌的安全访问
适用场景
- 自动化文档管理
- 内容检索和分析
- 团队知识库集成
- 自定义报告生成
- 与其他系统的数据同步
工具列表
- Smithery：用于自动安装和管理服务
- Python 环境：运行服务的基础环境
- Confluence REST API：后端集成的核心接口
常见问题解答
- 连接问题：检查 CONFLUENCE_BASE_URL 格式和网络连接
- 认证错误：验证用户名和 API 令牌是否正确
- 权限问题：确认用户有足够的 Confluence 权限
使用教程
使用依赖
- Python 3.8+
- pip (Python 包管理器)
- 具有 API 访问权限的活跃 Confluence 实例
- 有效的 Confluence API 令牌
安装教程
通过 Smithery 安装
npx -y @smithery/cli install @MahithChigurupati/confluence-mcp-server --client claude
手动安装
- 克隆仓库
git clone https://github.com/MahithChigurupati/Confluence-MCP-Server.git
cd Confluence-MCP-Server
- 设置虚拟环境
python -m venv venv
source venv/bin/activate # macOS/Linux
.\venv\Scripts\activate # Windows
- 安装依赖
pip install -r requirements.txt
配置
- 创建环境文件
cp .env.example .env
- 配置环境变量
CONFLUENCE_BASE_URL=https://your-instance.atlassian.net/wiki/rest/api
[email protected]
API_TOKEN=your-api-token-here
- 获取 Confluence API 令牌
- 访问 Atlassian API Tokens
- 点击 "Create API Token"
- 输入有意义的标签
- 立即复制生成的令牌
调试方式
启动服务器
python confluence.py
测试 API 方法
# 列出空间
response = await list_spaces(query="engineering", limit=25, start=0)
# 获取页面内容
response = await get_page_content(page_id="123456", version=2)
# 搜索内容
response = await search_content(query="project plan", space_key="TEAM", limit=50, start=0)
# 列出空间中的页面
response = await list_pages_in_space(space_key="TEAM", limit=100, start=0)