Confluence MCP 服务端

一个为 Confluence 设计的模型上下文协议（MCP）服务器，使 AI 助手能够通过标准化接口与 Confluence 内容交互。

ℹ️ 另有一个针对 Jira 的 独立 MCP 服务器

特性

• 使用个人 API 令牌进行身份验证
• 检索和搜索 Confluence 页面和空间
• 创建和更新 Confluence 内容
• 检索和添加页面评论
• 检索和添加页面附件
• 清理并转换 Confluence 内容以供 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。