Confluence MCP Server

与Confluence Data Center通过REST API交互的模型上下文协议（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空间中创建一个名为'Meeting Notes'的新页面，内容为'<p>我们的会议记录</p>'"
• "更新ID为123456的页面内容为'<p>更新的会议记录</p>'"
• "将页面123456的标题更改为'Revised Meeting Notes'"

许可证

MIT