Confluence Cloud MCP Server

Confluence Cloud MCP Server

site icon
2025.02.26 13
TypeScriptConfluence 管理AI 助手集成内容自动化交流协作
Confluence Cloud MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,旨在通过标准化接口帮助 AI 助手管理 Confluence Cloud 的空间、页面和内容。它提供了丰富的功能,包括空间管理、页面操作、搜索和标签管理等,适用于需要自动化管理 Confluence 内容的场景。
View on GitHub

Overview

基本能力

产品定位

Confluence Cloud MCP Server 是一个专为 AI 助手设计的服务,用于通过标准化接口与 Confluence Cloud 进行交互,实现空间、页面和内容的自动化管理。

核心功能

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

适用场景

  • AI 助手需要自动化管理 Confluence 内容。
  • 团队需要批量操作 Confluence 页面或空间。
  • 开发人员需要将 Confluence 内容转换为 Markdown 格式。

工具列表

  • 空间工具
  • list_confluence_spaces:列出所有空间。
  • get_confluence_space:获取特定空间的详情。
  • 页面工具
  • list_confluence_pages:列出空间中的页面。
  • get_confluence_page:获取页面内容(支持 Markdown 转换)。
  • create_confluence_page:创建新页面。
  • update_confluence_page:更新现有页面。
  • 搜索与标签工具
  • search_confluence_pages:使用 CQL 搜索内容。
  • get_confluence_labels:获取页面标签。
  • add_confluence_label:添加标签到页面。
  • remove_confluence_label:从页面移除标签。

常见问题解答

  • 如何安装?:推荐使用 Docker 镜像快速安装,或从源代码构建。
  • 如何配置?:需设置环境变量 CONFLUENCE_API_TOKENCONFLUENCE_EMAILCONFLUENCE_DOMAIN
  • 支持哪些功能?:支持空间管理、页面操作、搜索和标签管理。

使用教程

使用依赖

  • Docker(推荐)或 Node.js(从源代码构建时)。

安装教程

  1. 使用 Docker(推荐)
docker run --rm -i \
  -e CONFLUENCE_API_TOKEN=your-api-token \
  -e [email protected] \
  -e CONFLUENCE_DOMAIN=your-domain.atlassian.net \
  ghcr.io/aaronsb/confluence-cloud-mcp:latest
  1. 从源代码构建
git clone https://github.com/aaronsb/confluence-cloud-mcp.git
cd confluence-cloud-mcp
npm install
npm run build
node build/index.js

调试方式

  • 运行本地构建脚本:
./scripts/build-local.sh
CONFLUENCE_API_TOKEN=your-token CONFLUENCE_EMAIL=your-email ./scripts/run-local.sh
  • 检查环境变量是否正确设置。
  • 查看日志输出以排查问题。

许可证

该项目遵循 MIT 开源许可条款。