Atlassian Confluence MCP Server

Atlassian Confluence MCP Server

site icon
2025.04.14 3
TypeScript知识管理团队协作AI 集成交流协作
Atlassian Confluence MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,旨在作为 AI 助手(如 Anthropic's Claude、Cursor AI 或其他兼容 MCP 的客户端)与 Atlassian Confluence 实例之间的桥梁。它允许 AI 安全地实时访问和交互 Confluence 的空间和页面内容。
View on GitHub

Overview

产品定位

Atlassian Confluence MCP Server 是一个中间件服务,专注于将 AI 助手与 Confluence 知识库系统无缝集成,提供安全、高效的文档访问和交互能力。

核心功能

  1. Minimal Input, Maximum Output Philosophy: 仅需简单的标识符(如 spaceKeypageId)即可获取全面的信息。
  2. Complete Knowledge Base Access: 提供对 Confluence 文档、wiki 和知识库内容的实时全面访问。
  3. Rich Content Formatting: 自动将 Atlassian Document Format 转换为 Markdown,保留标题、表格、列表等格式元素。
  4. Secure Local Authentication: 凭证不存储在服务器中,所有操作在本地运行,确保安全性。
  5. Intuitive Markdown Responses: 所有响应使用结构化的 Markdown 格式,便于阅读和导航。

适用场景

  1. AI 辅助文档检索:AI 助手可以快速检索和引用 Confluence 中的文档内容。
  2. 知识库管理:实时访问和更新 Confluence 中的知识库内容。
  3. 团队协作:通过 AI 助手快速获取团队文档信息,提升协作效率。

工具列表

  1. list_spaces:列出可用的 Confluence 空间,支持过滤。
  2. get_space:获取特定空间的详细信息,包括主页信息。
  3. list_pages:列出空间中的页面,支持过滤。
  4. get_page:获取特定页面的完整内容和元数据。
  5. search:使用 CQL (Confluence Query Language) 搜索内容。

常见问题解答

  1. 如何获取 Atlassian API Token
  2. 访问 Atlassian API token 管理页面 创建并复制 API Token。
  3. 如何配置凭证
  4. 可以通过 MCP 配置文件或环境变量配置凭证。
  5. 如何连接 AI 助手
  6. 配置 MCP 兼容客户端以启动此服务器。

使用教程

使用依赖

  • Node.js (>=18.x):下载链接
  • Atlassian Account:需要访问 Confluence Cloud 的账户

安装教程

  1. 获取 Atlassian API Tokenbash # 访问 https://id.atlassian.com/manage-profile/security/api-tokens 创建并复制 API Token
  2. 配置凭证
  3. 方法 A:MCP 配置文件 json { "@aashari/mcp-server-atlassian-confluence": { "environments": { "ATLASSIAN_SITE_NAME": "<YOUR_SITE_NAME>", "ATLASSIAN_USER_EMAIL": "<YOUR_ATLASSIAN_EMAIL>", "ATLASSIAN_API_TOKEN": "<YOUR_COPIED_API_TOKEN>" } } }
  4. 方法 B:环境变量 bash ATLASSIAN_SITE_NAME="<YOUR_SITE_NAME>" \ ATLASSIAN_USER_EMAIL="<YOUR_EMAIL>" \ ATLASSIAN_API_TOKEN="<YOUR_API_TOKEN>" \ npx -y @aashari/mcp-server-atlassian-confluence
  5. 连接 AI 助手json { "mcpServers": { "aashari/mcp-server-atlassian-confluence": { "command": "npx", "args": ["-y", "@aashari/mcp-server-atlassian-confluence"] } } }

调试方式

  1. 快速使用 npxbash npx -y @aashari/mcp-server-atlassian-confluence list-spaces npx -y @aashari/mcp-server-atlassian-confluence get-page --page 12345678
  2. 全局安装bash npm install -g @aashari/mcp-server-atlassian-confluence mcp-atlassian-confluence list-spaces
  3. 查看帮助bash mcp-atlassian-confluence --help mcp-atlassian-confluence get-space --help mcp-atlassian-confluence search --help mcp-atlassian-confluence list-pages --help

许可证

该项目遵循 ISC 开源许可条款。