🚀 Atlassian Confluence MCP 服務器

本項目提供了一個模型上下文協議（MCP）服務器，它就像一座橋樑，連接著人工智能助手（例如 Anthropic 的 Claude、Cursor AI 或其他兼容 MCP 的客戶端）和您的 Atlassian Confluence 實例。藉助該服務器，AI 能夠安全地即時訪問並與您的 Confluence 空間和頁面進行交互。

🚀 快速開始

本服務器可讓人工智能助手與 Atlassian Confluence 實例建立連接，實現安全的即時交互。以下為您介紹安裝和使用的基本步驟：

安裝與運行

通過 npm 全局安裝命令行工具

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

使用示例命令

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

✨ 主要特性

什麼是 MCP？

模型上下文協議（MCP）是一項開放標準，它能讓人工智能系統安全且有針對性地連接到外部工具和數據源。本服務器針對 Confluence Cloud 實現了 MCP，成功將您的 Confluence 數據與 AI 助手連接起來。

為什麼使用此服務器？

最小輸入，最大輸出理念：僅需 spaceKey 和 pageId 等簡單標識符。每個工具都會返回全面詳細的信息，無需額外標誌。
完整的知識庫訪問：為您的 AI 助手提供對文檔、維基和知識庫內容的完全可見性，且內容即時可用。
豐富的格式化內容：所有頁面內容會自動從 Atlassian 文檔格式轉換為 Markdown，包含適當的標題、表格、列表和其他格式元素。
安全本地認證：憑據不會存儲在服務器中。該服務器在本地運行，您的令牌不會離開設備，並且您可以請求所需的權限。
直觀的 Markdown 內容：所有頁面內容以易於閱讀和編輯的 Markdown 格式返回。

💻 使用示例

命令行接口（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."
    }
  ]
}