HelloWorld
登录
C

Confluence 服务器

一台通过REST API使AI模型能够与Confluence数据中心交互的服务器，提供搜索、读取、创建、更新和删除页面等操作。

content-management-systemsdocumentation-accessdeveloper-tools

150 查看 · 2026-07-07 更新

简介

一台通过REST API使AI模型能够与Confluence数据中心交互的服务器，提供搜索、读取、创建、更新和删除页面等操作。

简介

一台通过REST API使AI模型能够与Confluence数据中心交互的服务器，提供搜索、读取、创建、更新和删除页面等操作。

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

来源