confluence-mcp

🚀 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。