使用说明
汇流MCP服务器
一种模型上下文协议（MCP）服务器，用于通过REST API与Confluence数据中心交互。该服务器提供了一组工具，允许AI模型与Confluence内容进行交互。
特性
此MCP服务器为Confluence提供以下操作：
- 执行CQL（汇流查询语言）搜索
- 按ID获取页面内容
- 使用正文获取页面内容
- 按空格键查找页面
- 按标题和空格键查找页面
- 创建新页面（可选父页面）
- 更新现有页面
- 删除页面
安装
- 克隆此存储库
- 安装依赖项：
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：汇流页IDcontent：存储格式（HTML）的新页面内容title：页面的可选新标题spaceKey：可选空格键（仅在更改空格时需要）
删除_页
按ID删除页面。
参数：
pageId：汇流页ID
示例用法
一旦服务器运行并连接到AI模型，您就可以使用自然语言与Confluence进行交互。例如：
- “查找DOCS空间中的所有页面”
- “获取ID为123456的页面内容”
- “在团队空间中创建一个名为“会议笔记”的新页面，其中包含内容”
会议记录
'" - “更新ID为123456的页面以包含内容”
更新会议记录
'" - 将第123456页的标题更新为“修订后的会议记录”
许可证
麻省理工学院
