Confluence MCP

🚀 Confluence MCP 服務端

Confluence MCP 服務端是一個專為 Confluence 設計的模型上下文協議（MCP）服務器，它允許 AI 助手通過標準化接口與 Confluence 內容進行交互，為信息的檢索、創建和更新等操作提供了便利。

ℹ️ 另有一個針對 Jira 的 獨立 MCP 服務器

✨ 主要特性

• 使用個人 API 令牌進行身份驗證，保障系統安全。
• 支持檢索和搜索 Confluence 頁面和空間，方便快速定位所需信息。
• 可創建和更新 Confluence 內容，實現信息的動態管理。
• 能夠檢索和添加頁面評論，促進信息交流。
• 支持檢索和添加頁面附件，豐富內容形式。
• 清理並轉換 Confluence 內容以供 AI 使用，提升 AI 處理效率。
• 處理 API 通信、錯誤處理和數據轉換，確保系統穩定運行。
• 具備基本速率限制功能，防止 API 被濫用，保護系統資源。

📦 安裝指南

先決條件

• Bun (版本 1.0.0 或更高)
• 具有 API 訪問權限的 Confluence 賬戶

安裝步驟

# 克隆倉庫
git clone https://github.com/cosmix/confluence-mcp.git
cd confluence-mcp

# 安裝依賴項
bun install

# 構建項目
bun run build

📚 詳細文檔

配置

使用此 MCP 服務器，您需要設置以下環境變量：

CONFLUENCE_API_TOKEN=your_api_token
CONFLUENCE_BASE_URL=your_confluence_instance_url  # 例如，https://your-domain.atlassian.net/wiki
CONFLUENCE_USER_EMAIL=your_email

Claude Desktop / Cline 配置

將以下配置添加到您的設置文件中：

{
  "mcpServers": {
    "confluence": {
      "command": "bun",
      "args": ["/absolute/path/to/confluence-mcp/dist/index.js"], 
      "config": {
        "developmentMode": true,
        "apiEndpoint": "http://localhost:3000"
      }
    }
  }
}

開發

# 在開發模式下運行
bun run dev

# 運行測試
npm test

工具

檢索內容

獲取頁面（get_page）

get_page({
  space: string, // 空間名稱，如 "MySpace"
  title: string   // 頁面標題，如 "HomePage"
}): Promise<Page>

搜索內容（search_content）

search_content(query: string): Promise<SearchResult[]>

創建更新

創建頁面（create_page）

create_page({
  space: string,
  title: string,
  content: string // 支持 CommonMark 和 HTML 格式
}): Promise<Page>

更新頁面（update_page）

update_page({
  id: string,
  version: number,
  content: string
}): Promise<void>

管理內容

刪除頁面（delete_page）

delete_page(id: string, version?: number): Promise<void>

📄 許可證

本項目在 MIT License 下 licensed。