Confluence MCP Server

Confluence MCP 服务

一个通过 REST API 与 Confluence Data Center 交互的模型上下文协议（MCP）服务。此服务提供一组工具，允许 AI 模型与 Confluence 内容交互。

功能

此 MCP 服务提供以下 Confluence 操作：

• 执行 CQL（Confluence 查询语言）搜索
• 按 ID 获取页面内容
• 获取包含正文的页面内容
• 按空间键查找页面
• 按标题和空间键查找页面
• 创建新页面（可选指定父页面）
• 更新现有页面
• 删除页面

安装

1. 克隆此仓库
2. 安装依赖项：

pip install -r requirements.txt

配置

在项目根目录中创建一个 .env 文件，并添加以下变量：

CONFLUENCE_API_BASE=http://localhost:8090/rest/api
CONFLUENCE_USERNAME=your_username
CONFLUENCE_PASSWORD=your_password

根据你的 Confluence 实例调整这些值。

运行服务

开发模式（推荐）

运行 MCP 服务的正确方式是使用 MCP CLI 工具的开发模式。此模式会启动 MCP Inspector UI，让你能够测试和调试服务：

mcp dev confluence.py

默认情况下，MCP Inspector 会在 http://127.0.0.1:6274 启动。

直接执行（不推荐）

MCP 服务的设计运行方式是使用 MCP CLI 工具，或与 Claude Desktop 集成。直接使用 Python 执行并非运行 MCP 服务的标准方式，但此脚本包含用于测试的回退模式：

python confluence.py

不过，此模式的功能有限，仅用于基本测试。

在 Claude Desktop 中安装

要在 Claude Desktop 中安装此服务：

mcp install confluence.py

API 参考

execute_cql_search

在 Confluence 上执行 CQL 查询以搜索页面。

参数：

• cql：CQL 查询字符串
• limit：要返回的结果数量（默认值：10）

get_page_content

获取 Confluence 页面的内容。

参数：

• pageId：Confluence 页面 ID

get_page_with_body

获取包含正文内容的页面。

参数：

• pageId：Confluence 页面 ID

find_pages_by_space

按空间键查找页面。

参数：

• spaceKey：Confluence 空间键
• limit：要返回的最大结果数量（默认值：10）
• expand：可选的逗号分隔属性列表，用于展开

find_page_by_title

按标题和空间键查找页面。

参数：

• title：页面标题
• spaceKey：Confluence 空间键

create_page

在 Confluence 中创建新页面。

参数：

• title：页面标题
• spaceKey：Confluence 空间键
• content：采用存储格式（HTML）的页面内容
• parentId：可选的父页面 ID

update_page

更新 Confluence 中的现有页面。

参数：

• pageId：Confluence 页面 ID
• content：采用存储格式（HTML）的新页面内容
• title：页面的新标题（可选）
• spaceKey：空间键（可选，仅在更改空间时需要）

delete_page

按 ID 删除页面。

参数：

• pageId：Confluence 页面 ID

使用示例

服务运行并连接到 AI 模型后，你可以使用自然语言与 Confluence 交互。例如：

• “查找 DOCS 空间中的所有页面”
• “获取 ID 为 123456 的页面内容”
• “在 TEAM 空间中创建一个名为 ‘Meeting Notes’ 的新页面，内容为 ‘

  Notes from our meeting

  ’”
• “将 ID 为 123456 的页面内容更新为 ‘

  Updated meeting notes

  ’”
• “将页面 123456 的标题更新为 ‘Revised Meeting Notes’”

许可证

MIT