HelloWorld
登录
m

masna-ai

content-management-systemsdocumentation-accessdeveloper-tools

49 查看 · 2026-07-07 更新

Confluence MCP 服务器

一个用于通过 REST API 与 Confluence Data Center 交互的模型上下文协议 (MCP) 服务器。此服务器提供了一组工具，允许 AI 模型与 Confluence 内容进行交互。

功能

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

  • 执行 CQL（Confluence 查询语言）搜索
  • 通过 ID 获取页面内容
  • 获取带有正文的页面内容
  • 通过空间键查找页面
  • 通过标题和空间键查找页面
  • 创建新页面（可选父页面）
  • 更新现有页面
  • 删除页面

安装

  1. 克隆此仓库
  2. 安装依赖项：

bash 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，允许您测试和调试服务器：

bash mcp dev confluence.py

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

直接执行（不推荐）

MCP 服务器设计为使用 MCP CLI 工具或集成到 Claude Desktop 中运行。直接使用 Python 执行不是标准方式，但脚本中包含了一个用于测试的回退模式：

bash python confluence.py

然而，这种模式功能有限，仅用于基本测试。

在 Claude Desktop 中安装

要在 Claude Desktop 中安装服务器：

bash mcp install confluence.py

API 参考

execute_cql_search

在 Confluence 上执行 CQL 查询以搜索页面。

参数：

  • cql: CQL 查询字符串
  • limit: 返回的结果数量（默认：10）

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 空间中创建一个标题为 '会议记录' 的新页面，内容为 '

    会议笔记

    '"
  • "将 ID 为 123456 的页面内容更新为 '

    更新后的会议笔记

    '"
  • "将 ID 为 123456 的页面标题更新为 '修订后的会议记录'"

许可证

MIT

来源