@solumon/mcp-server-confluence

用于读取 Confluence Server/DC 文档的 MCP 服务，支持图片。

功能特性

使用 CQL 搜索 Confluence 页面
获取页面内容（HTML 或 Wiki 格式）
获取页面元数据
列出空间
获取页面树结构
下载页面图片和附件
新建页面（空间根或子页面）
更新已有页面（标题或正文）
将页面移动到另一空间（可指定父页面、改名）

安装

本服务通过 npx 直接运行，无需单独安装。只需在下方配置中引用 @solumon/mcp-server-confluence，Cursor / Claude Code 启动时会自动拉取。

如需在命令行手动使用，也可全局安装：

npm install -g @solumon/mcp-server-confluence

配置

环境变量

CONFLUENCE_URL=http://your-confluence-server.com
CONFLUENCE_USERNAME=your_username
CONFLUENCE_PASSWORD=your_password

Cursor 配置

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "mcp-server-confluence": {
      "command": "npx",
      "args": ["-y", "@solumon/mcp-server-confluence"],
      "env": {
        "CONFLUENCE_URL": "http://your-confluence-server.com",
        "CONFLUENCE_USERNAME": "your_username",
        "CONFLUENCE_PASSWORD": "your_password"
      }
    }
  }
}

Claude Code 配置

添加到 ~/.claude.json：

{
  "mcpServers": {
    "mcp-server-confluence": {
      "command": "npx",
      "args": ["-y", "@solumon/mcp-server-confluence"],
      "env": {
        "CONFLUENCE_URL": "http://your-confluence-server.com",
        "CONFLUENCE_USERNAME": "your_username",
        "CONFLUENCE_PASSWORD": "your_password"
      }
    }
  }
}

可用工具

工具	说明
`confluence_search`	使用 CQL 搜索页面
`confluence_get_page`	获取页面内容（HTML/Wiki）
`confluence_get_page_metadata`	获取页面元数据
`confluence_list_spaces`	列出可用空间
`confluence_get_page_tree`	获取页面树结构
`confluence_list_attachments`	列出页面附件
`confluence_list_page_images`	列出页面中引用的图片
`confluence_get_page_images`	下载页面图片（Base64）
`confluence_get_attachment`	下载单个附件
`confluence_create_page`	新建页面（空间根或子页面，wiki 标记）
`confluence_update_page`	更新已有页面（标题/正文，wiki 标记）
`confluence_move_page`	将页面移动到另一空间（可指定父页面/改名）

使用示例

搜索页面

使用 confluence_search 在空间 "PROJ" 中搜索 "需求"

获取页面内容

使用 confluence_get_page 获取页面 123456 的内容

获取页面图片

使用 confluence_get_page_images 获取页面 123456 的所有图片

下载附件

使用 confluence_get_attachment 从页面 123456 下载 "screenshot.png"

新建页面

使用 confluence_create_page 在空间 "PROJ" 新建标题为 "测试页" 的页面，内容为 wiki 标记
使用 confluence_create_page 以 parentId=123456 在指定页下新建子页面

更新页面

使用 confluence_update_page 更新页面 123456 的标题，或更新其正文（wiki 标记）

移动页面

使用 confluence_move_page 将页面 123456 移动到空间 "TARGET"
使用 confluence_move_page 将页面 123456 移到空间 "TARGET" 的父页面 789 下，并改标题为 "新标题"

许可证

MIT

@solumon/confluence-mcp