汇聚云-MCP

Name: 汇聚云-MCP
Author: aaronsb

作者：aaronsb15 星标更新：2025-08-01

安装使用来源：spider==github.com

项目介绍

Confluence Cloud MCP Server

这是一个提供与Confluence Cloud交互工具的Model Context Protocol (MCP)服务器。该服务器使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：本地构建

克隆仓库：

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

使用本地构建脚本进行构建和运行：

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

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

方案3：使用npx（直接从GitHub）

无需安装即可直接从GitHub运行：

# 使用内联环境变量
CONFLUENCE_DOMAIN=your-domain.atlassian.net \
CONFLUENCE_EMAIL=your-email@domain.com \
CONFLUENCE_API_TOKEN=your-api-token \
npx github:aaronsb/confluence-cloud-mcp

# 或使用环境文件
npx github:aaronsb/confluence-cloud-mcp --env /path/to/.env

创建一个包含您的Confluence凭证的.env文件：

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

方案4：从源代码

安装依赖项：

npm install

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

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

构建项目：

npm run build

运行服务器：

node build/index.js

使用方法

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

使用Claude Code CLI：

claude mcp add confluence-cloud npx -- github:aaronsb/confluence-cloud-mcp --env /path/to/.env

在MCP配置中使用npx：

{
  "mcpServers": {
    "confluence": {
      "command": "npx",
      "args": ["github:aaronsb/confluence-cloud-mcp", "--env", "/path/to/.env"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

使用Docker：

{
  "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": []
    }
  }
}

注意：如果您是像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进行持续集成和部署：

在拉取请求时进行自动化测试和代码检查
在主分支提交时自动构建Docker镜像
多架构镜像构建（amd64, arm64）
将容器发布到GitHub容器注册表

本地开发

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

./scripts/build-local.sh：构建项目并创建本地Docker镜像
./scripts/run-local.sh：使用您的凭证运行本地Docker镜像

许可证

MIT