Atlassian Confluence MCP 服务器

这个项目提供一个模型上下文协议（MCP）服务器，作为人工智能助手（如 Anthropic 的 Claude、Cursor AI 或其他兼容 MCP 的客户端）和您的 Atlassian Confluence 实例之间的桥梁。它允许 AI 安全地实时访问和交互您的 Confluence 空间和页面。

概览

什么是 MCP？

模型上下文协议（MCP）是一个开放标准，允许人工智能系统安全且上下文相关地连接到外部工具和数据源。

此服务器针对 Confluence Cloud 实现了 MCP，将您的 Confluence 数据与 AI 助手桥接在一起。

为什么使用此服务器？

• 最小输入，最大输出理念：只需简单的标识符如 spaceKey 和 pageId 即可。每个工具都会返回全面的详细信息，而无需额外标志。
• 完整的知识库访问：为您的 AI 助手提供对文档、维基和知识库内容的完全可见性，实时可用。
• 丰富的格式化内容：所有页面内容自动从 Atlassian 文档格式转换为 Markdown，带有适当的标题、表格、列表和其他格式元素。
• 安全本地认证：凭据从未存储在服务器中。该服务器在本地运行，因此您的令牌永远不会离开设备，并且您可以请求所需的权限。
• 直观的 Markdown 内容：所有页面内容以易于阅读和编辑的 Markdown 格式返回。

快速入门指南

安装与运行

1. 通过 npm 安装全局命令行工具

   npm install -g @aashari/mcp-server-atlassian-confluence
   

2. 使用示例命令

   mcp-atlassian-confluence --help
   # 查看所有可用命令及其选项
   

   mcp-atlassian-confluence list-spaces
   # 列出所有 Confluence 空间
   

   mcp-atlassian-confluence get-page --page-id 12345678
   # 获取指定页面的内容
   

配置指南

步骤 1: 安装依赖

npm install @aashari/mcp-server-atlassian-confluence

步骤 2: 启动服务器

npx @aashari/mcp-server-atlassian-confluence start

命令行接口（CLI）

使用 npx 快速运行

npx -y @aashari/mcp-server-atlassian-confluence list-spaces
npx -y @aashari/mcp-server-atlassian-confluence get-page --page 12345678

全局安装后使用

mcp-atlassian-confluence list-spaces
# 列出所有 Confluence 空间

工具接口（API）

以下是 MCP 服务器提供的主要工具及其用法：

1. list-spaces

列出所有可用的 Confluence 空间。

{
  "spaces": [
    {
      "id": "123456",
      "key": "MySpaceKey",
      "name": "My Space Name"
    }
  ]
}

2. get-page

获取指定页面的内容。

mcp-atlassian-confluence get-page --page-id 12345678

返回结果：

{
  "id": "12345678",
  "title": "My Page Title",
  "content": "# My Page Heading\nThis is the content of my page."
}

3. search

使用 CQL 搜索 Confluence 内容。

mcp-atlassian-confluence search --cql "text ~ 'project plan'"

返回结果：

{
  "results": [
    {
      "id": "12345679",
      "title": "Project Plan Document",
      "content": "This document outlines our project plan for Q3."
    }
  ]
}

许可证

ISC License