MCP Confluence Server

汇流MCP服务器

一种模型上下文协议（MCP）服务器，用于通过REST API与Confluence数据中心交互。该服务器提供了一组工具，允许AI模型与Confluence内容进行交互。

特性

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

• 执行CQL（汇流查询语言）搜索
• 按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检查器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：汇流页ID

get_page_with_body

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

参数：

• pageId：汇流页ID

find_pages_by_space

按空格键查找页面。

参数：

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

find_page_by_title

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

参数：

• title：页面标题
• spaceKey：汇流空间键

创建页面

在Confluence中创建一个新页面。

参数：

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

update_page

更新Confluence中的现有页面。

参数：

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

删除_页

按ID删除页面。

参数：

• pageId：汇流页ID

示例用法

一旦服务器运行并连接到AI模型，您就可以使用自然语言与Confluence进行交互。例如：

• “查找DOCS空间中的所有页面”
• “获取ID为123456的页面内容”
• “在团队空间中创建一个名为“会议笔记”的新页面，其中包含内容”

会议记录 '"

• “更新ID为123456的页面以包含内容”

更新会议记录 '"

• 将第123456页的标题更新为“修订后的会议记录”

许可证

麻省理工学院