Confluence MCP (Cosmix)

汇流MCP

Confluence的模型上下文协议（MCP）服务器，使AI助手能够通过标准化的界面与Confluence内容进行交互。

ℹ️ 有一个单独的MCP服务器 为Jira

特性

• 使用个人API令牌对Confluence进行身份验证
• 检索和搜索Confluence页面和空间
• 创建和更新Confluence内容
• 检索并向页面添加评论
• 检索并向页面添加附件
• 为AI消费清理和转换Confluence内容
• 处理API通信、错误处理和数据转换
• 防止API滥用的基本费率限制

先决条件

• 包子 （v1.0.0或更高版本）
• 具有API访问权限的汇流帐户

安装

# Clone the repository
git clone https://github.com/cosmix/confluence-mcp.git
cd confluence-mcp

# Install dependencies
bun install

# Build the project
bun run build

配置

要使用此MCP服务器，您需要设置以下环境变量：

CONFLUENCE_API_TOKEN=your_api_token
CONFLUENCE_BASE_URL=your_confluence_instance_url  # e.g., https://your-domain.atlassian.net/wiki
CONFLUENCE_USER_EMAIL=your_email

Claude桌面/客户端配置

将此配置添加到您的设置文件中：

{
  "mcpServers": {
    "confluence": {
      "command": "bun",
      "args": ["/absolute/path/to/confluence-mcp/dist/index.js"],
      "env": {
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "CONFLUENCE_BASE_URL": "your_confluence_instance_url/wiki",
        "CONFLUENCE_USER_EMAIL": "your_email"
      }
    }
  }
}

发展

# Run in development mode
bun run dev

# Run tests
bun test

可用工具

Confluence MCP服务器提供以下工具：

get_page

按ID检索Confluence页面。格式是指内容的返回格式，可以是 text 或 markdownThe includeMarkup 参数允许检索原始的Confluence存储格式（XHTML）标记，这对于在保留格式的同时更新页面非常有用。

{
  "pageId": "123456",
  "format": "text",
  "includeMarkup": true
}

搜索页面

使用CQL（汇流查询语言）搜索汇流页面。格式是指内容的返回格式，可以是 text 或 markdownThe includeMarkup 参数允许检索每个页面的原始Confluence存储格式（XHTML）标记。

{
  "query": "space = DEV and label = documentation",
  "limit": 10,
  "format": "text",
  "includeMarkup": true
}

get_space

列出所有可用的汇流空间。

{
  "limit": 50
}

创建页面

创建一个新的Confluence页面。这 parentId 是可选的，可用于在现有页面下创建子页面。

{
  "spaceKey": "DEV",
  "title": "New Page Title",
  "content": "
Page content in Confluence Storage Format (XHTML)
",
  "parentId": "123456"
}

update_page

更新现有的Confluence页面。

{
  "pageId": "123456",
  "title": "Updated Page Title",
  "content": "
Updated content in Confluence Storage Format (XHTML)
",
  "version": 1
}

获取_注释

检索特定Confluence页面的评论。格式是指内容的返回格式，可以是 text 或 markdown.

{
  "pageId": "123456",
  "limit": 25,
  "format": "text"
}

添加注释

在Confluence页面添加评论。这 parentId 对于创建线程回复是可选的。

{
  "pageId": "123456",
  "content": "
This is a new comment.
",
  "parentId": "789012"
}

获取附件

检索特定Confluence页面的附件。

{
  "pageId": "123456",
  "limit": 25
}

添加附件

向Confluence页面添加附件。这 fileContentBase64 应该是文件内容的base64编码字符串。

{
  "pageId": "123456",
  "filename": "document.pdf",
  "fileContentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+P...",
  "comment": "Uploaded new version of the document"
}

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。