Confluence MCP 服务器

这是一个通过 REST API 与 Confluence 数据中心交互的模型上下文协议 (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

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

直接执行（不推荐）

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: 返回的结果数量（默认：110）

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 空间中创建一个名为 '会议记录' 的新页面，内容为 '<p>我们的会议记录</p>'"
• "更新 ID 为 123456 的页面内容为 '<p>更新的会议记录</p>'"
• "将页面 123456 的标题更改为 '修订会议记录'"

许可证

MIT </中文翻译>