Confluence MCP Server

Confluence MCP Server

site icon
2025.03.26 2
Python团队协作内容管理交流协作
Confluence MCP Server 是一个为 Atlassian Confluence 实现的 Model Context Protocol (MCP) 服务器。它提供了一套工具,通过 MCP 协议与 Confluence 进行交互,使 AI 代理能够无缝地处理 Confluence 内容。该服务器基于 Flask 构建,便于部署到 Cloud Run。
View on GitHub

Overview

基本能力

产品定位

Confluence MCP Server 是一个为 Atlassian Confluence 实现的 MCP 服务器,旨在通过 MCP 协议提供与 Confluence 的无缝交互能力,特别适用于 AI 代理处理 Confluence 内容。

核心功能

  • 使用 Confluence Query Language (CQL) 搜索页面和空间
  • 列出所有可用的 Confluence 空间
  • 创建、读取、更新和删除 Confluence 页面
  • 支持 Confluence 资源的丰富元数据
  • 基于 Flask 的服务器,便于部署到 Cloud Run
  • 提供 MCP 工具,便于 AI 代理集成

适用场景

  • AI 代理与 Confluence 内容的交互
  • 自动化管理 Confluence 页面和空间
  • 团队协作中的内容管理自动化

工具列表

  1. Search Content: 搜索 Confluence 内容
  2. Get Spaces: 获取所有 Confluence 空间
  3. Get Page Content: 获取特定页面内容
  4. Create Page: 创建新页面
  5. Update Page: 更新现有页面
  6. Delete Page: 删除页面

常见问题解答

  • 如何获取访问令牌? 登录 Atlassian 账户,进入账户设置 > 安全 > 创建和管理 API 令牌,创建并复制新令牌。
  • 如何处理错误? 所有工具都包含适当的错误处理,错误时将返回 {"error": "error message"}

使用教程

使用依赖

安装依赖:

pip install -r requirements.txt

安装教程

  1. 克隆仓库
  2. 创建 .env 文件并配置以下变量:
CONFLUENCE_URL=https://your-instance.atlassian.net/wiki
CONFLUENCE_ACCESS_TOKEN=your_access_token
PORT=8080  # 可选,默认为 8080

调试方式

运行本地服务器:

python example.py

服务器将启动在 http://localhost:8080

Cloud Run 部署

  1. 构建 Docker 镜像:
docker build -t confluence-mcp .
  1. 标记并推送到 Google Container Registry:
docker tag confluence-mcp gcr.io/[PROJECT-ID]/confluence-mcp
docker push gcr.io/[PROJECT-ID]/confluence-mcp
  1. 部署到 Cloud Run:
gcloud run deploy confluence-mcp \
  --image gcr.io/[PROJECT-ID]/confluence-mcp \
  --platform managed \
  --allow-unauthenticated \
  --set-env-vars="CONFLUENCE_URL=[YOUR_URL],CONFLUENCE_ACCESS_TOKEN=[YOUR_TOKEN]"

许可证

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