🚀 Confluence MCP 服务端
Confluence MCP 服务端是一个专为 Confluence 设计的模型上下文协议（MCP）服务器，它允许 AI 助手通过标准化接口与 Confluence 内容进行交互，为信息的检索、创建和更新等操作提供了便利。
ℹ️ 另有一个针对 Jira 的 独立 MCP 服务器
✨ 主要特性
- 使用个人 API 令牌进行身份验证，保障系统安全。
- 支持检索和搜索 Confluence 页面和空间，方便快速定位所需信息。
- 可创建和更新 Confluence 内容，实现信息的动态管理。
- 能够检索和添加页面评论，促进信息交流。
- 支持检索和添加页面附件，丰富内容形式。
- 清理并转换 Confluence 内容以供 AI 使用，提升 AI 处理效率。
- 处理 API 通信、错误处理和数据转换，确保系统稳定运行。
- 具备基本速率限制功能，防止 API 被滥用，保护系统资源。
📦 安装指南
先决条件
- Bun (版本 1.0.0 或更高)
- 具有 API 访问权限的 Confluence 账户
安装步骤
# 克隆仓库
git clone https://github.com/cosmix/confluence-mcp.git
cd confluence-mcp
# 安装依赖项
bun install
# 构建项目
bun run build
📚 详细文档
配置
使用此 MCP 服务器，您需要设置以下环境变量：
CONFLUENCE_API_TOKEN=your_api_token
CONFLUENCE_BASE_URL=your_confluence_instance_url # 例如，https://your-domain.atlassian.net/wiki
CONFLUENCE_USER_EMAIL=your_email
Claude Desktop / Cline 配置
将以下配置添加到您的设置文件中：
{
"mcpServers": {
"confluence": {
"command": "bun",
"args": ["/absolute/path/to/confluence-mcp/dist/index.js"],
"config": {
"developmentMode": true,
"apiEndpoint": "http://localhost:3000"
}
}
}
}
开发
# 在开发模式下运行
bun run dev
# 运行测试
npm test
工具
检索内容
获取页面（get_page）
get_page({
space: string, // 空间名称，如 "MySpace"
title: string // 页面标题，如 "HomePage"
}): Promise<Page>
搜索内容（search_content）
search_content(query: string): Promise<SearchResult[]>
创建更新
创建页面（create_page）
create_page({
space: string,
title: string,
content: string // 支持 CommonMark 和 HTML 格式
}): Promise<Page>
更新页面（update_page）
update_page({
id: string,
version: number,
content: string
}): Promise<void>
管理内容
删除页面（delete_page）
delete_page(id: string, version?: number): Promise<void>
📄 许可证
本项目在 MIT License 下 licensed。