@solumon/confluence-mcp

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

功能特性

• 使用 CQL 搜索 Confluence 页面
• 获取页面内容（HTML 或 Wiki 格式）
• 获取页面元数据
• 列出空间
• 获取页面树结构
• 下载页面图片和附件

安装

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

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

npm install -g @solumon/confluence-mcp

配置

环境变量

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

Cursor 配置

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

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

Claude Code 配置

添加到 ~/.claude.json：

{
  "mcpServers": {
    "confluence": {
      "command": "npx",
      "args": ["-y", "@solumon/confluence-mcp"],
      "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_search 在空间 "PROJ" 中搜索 "需求"

获取页面内容

使用 confluence_get_page 获取页面 123456 的内容

获取页面图片

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

下载附件

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

许可证

MIT