Confluence Cloud MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供与 Confluence Cloud 交互的工具。该服务器使 AI 助手能够通过标准化接口管理 Confluence 空间、页面和内容。

功能

• 空间管理
  • 列出空间
  • 获取空间详情
• 页面操作
  • 创建、读取、更新页面
  • 列出空间中的页面
  • 将页面内容从 Confluence 存储格式转换为 Markdown
• 搜索 & 标签
  • 使用 CQL 搜索内容
  • 管理页面标签

设置

选项 1：使用 Docker（推荐）

使用此服务器最简单的方法是使用预构建的 Docker 镜像：

docker run --rm -i \
  -e CONFLUENCE_API_TOKEN=your-api-token \
  -e CONFLUENCE_EMAIL=your-email@domain.com \
  -e CONFLUENCE_DOMAIN=your-domain.atlassian.net \
  ghcr.io/aaronsb/confluence-cloud-mcp:latest

选项 2：本地构建

1. 克隆存储库：

git clone https://github.com/aaronsb/confluence-cloud-mcp.git
cd confluence-cloud-mcp

2. 使用本地构建脚本构建和运行：

# 构建 Docker 镜像
./scripts/build-local.sh

# 运行服务器
CONFLUENCE_API_TOKEN=your-token CONFLUENCE_EMAIL=your-email ./scripts/run-local.sh

选项 3：从源代码

1. 安装依赖项：

npm install

2. 配置环境变量： 创建一个包含您的 Confluence 凭据的 .env 文件：

CONFLUENCE_DOMAIN=your-domain.atlassian.net
CONFLUENCE_EMAIL=your-email@domain.com
CONFLUENCE_API_TOKEN=your-api-token

3. 构建项目：

npm run build

4. 运行服务器：

node build/index.js

用法

通过将其添加到 MCP 配置中，可以将服务器与 MCP 兼容的 AI 助手集成：

{
  "mcpServers": {
    "confluence": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/aaronsb/confluence-cloud-mcp:latest"],
      "env": {
        "CONFLUENCE_DOMAIN": "your-domain.atlassian.net",
        "CONFLUENCE_EMAIL": "your-email@domain.com",
        "CONFLUENCE_API_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

AI 助手注意：如果您是像 Cline 这样的 AI 助手，并且尝试安装此 MCP 服务器，请参阅 llms-install.md 文件以获取详细的安装说明。

可用工具

空间工具

• list_confluence_spaces: 列出 Confluence 中的所有空间
• get_confluence_space: 获取有关特定空间的详细信息

页面工具

• list_confluence_pages: 列出空间中的页面
• get_confluence_page: 获取包含其内容的特定页面（现在包括 Markdown 转换）
• create_confluence_page: 在空间中创建一个新页面
• update_confluence_page: 更新现有页面

get_confluence_page 工具现在自动将 Confluence 存储格式内容转换为 Markdown，从而更容易处理页面内容。转换处理：

• 标题 (h1-h6)
• 列表（有序和无序）
• 链接
• 强调（粗体/斜体）
• 代码块
• 表格
• 段落和换行符

搜索 & 标签工具

• search_confluence_pages: 使用 CQL 搜索 Confluence 内容
• get_confluence_labels: 获取页面的标签
• add_confluence_label: 向页面添加标签
• remove_confluence_label: 从页面删除标签

注意：所有工具名称都遵循 [动词]confluence[名词] 命名约定，以保持一致性和清晰度。

开发

该项目用 TypeScript 编写，并遵循 MCP SDK 约定来实现服务器功能。代码库组织成：

• src/client/ - Confluence API 客户端实现
• src/handlers/ - MCP 工具请求处理程序
• src/schemas/ - 工具输入的 JSON 模式
• src/types/ - TypeScript 类型定义
• src/utils/ - 实用程序函数，包括内容格式转换

CI/CD 管道

该项目使用 GitHub Actions 进行持续集成和部署：

• 在拉取请求上进行自动化测试和 linting
• 在主分支提交时自动构建 Docker 镜像
• 多架构镜像构建 (amd64, arm64)
• 将容器发布到 GitHub Container Registry

本地开发

对于本地开发，请使用提供的脚本：

• ./scripts/build-local.sh: 构建项目并创建一个本地 Docker 镜像
• ./scripts/run-local.sh: 使用您的凭据运行本地 Docker 镜像

许可证

MIT