用途
mcp-confluence-server 是一个 Model Context Protocol (MCP) 服务器，旨在通过 Confluence Data Center 的 REST API 实现与 Confluence 的交互。它使 AI 模型能够通过自然语言操作 Confluence 内容，例如搜索、读取、创建、更新和删除页面。
主要能力
该服务器提供以下操作工具：
- execute_cql_search: 执行 CQL (Confluence Query Language) 查询以搜索页面。参数：cql（CQL 查询字符串）、limit（返回结果数量，默认 10）。
- get_page_content: 根据页面 ID 获取 Confluence 页面的内容。参数：pageId（Confluence 页面 ID）。
- get_page_with_body: 获取页面及其正文内容。
- find_pages_by_space: 根据空间键查找页面。参数：spaceKey（Confluence 空间键）、limit（最大返回结果数，默认 10）、expand（可选的逗号分隔属性列表）。
- find_page_by_title: 根据标题和空间键查找页面。参数：title（页面标题）。
- create_page: 在 Confluence 中创建新页面。参数：content（存储格式的页面内容，HTML）、parentId（可选的父页面 ID）。
- update_page: 更新 Confluence 中的现有页面。参数：content（新的页面内容，存储格式 HTML）、title（可选的新标题）、spaceKey（可选的空间键，仅在更改空间时需要）。
- delete_page: 根据 ID 删除页面。
使用方式
安装
- 克隆仓库：
git clone <repository-url> - 安装依赖。
- 在项目根目录创建
.env文件，包含必要的变量（需根据 Confluence 实例调整值）。
运行服务器
开发模式（推荐）：使用 MCP CLI 工具以开发模式运行，这会启动 MCP Inspector UI 以便测试和调试服务器。默认情况下，MCP Inspector 将在 http://127.0.0.1:6274 启动。
直接执行（不推荐）：虽然可以使用 Python 直接执行脚本，但这并非 MCP 服务器的标准运行方式，功能有限，仅用于基本测试。
在 Claude Desktop 中安装
可将服务器安装到 Claude Desktop 中使用。
适用场景
- 通过自然语言查询和操作 Confluence 内容，如“查找 DOCS 空间中的所有页面”、“获取 ID 为 123456 的页面内容”、“在 TEAM 空间中创建标题为‘会议记录’的新页面，内容为‘会议笔记’”、“将 ID 为 123456 的页面内容更新为‘更新的会议笔记’”、“将页面 123456 的标题更新为‘修订后的会议记录’”。
限制
- 直接使用 Python 执行时功能有限，仅用于测试。
- 需要正确配置
.env文件以连接 Confluence 实例。 - 目前暂未提供关于认证方式、具体依赖安装命令、Claude Desktop 安装详细步骤等信息。
