Confluence Data Center

🚀 Confluence MCP 服務器

Confluence MCP 服務器是一個用於與 Confluence Data Center 進行交互的模型上下文協議（MCP）服務器。它提供了一系列實用工具，能讓 AI 模型與 Confluence 中的內容進行交互，為數據處理和信息獲取提供便利。

✨ 主要特性

此 MCP 服務器為 Confluence 提供了豐富的操作功能：

• 執行 CQL（Confluence 查詢語言）搜索，精準定位所需頁面。
• 根據 ID 獲取頁面內容，快速獲取指定頁面信息。
• 帶正文獲取頁面內容，全面掌握頁面詳情。
• 根據空間鍵查找頁面，高效篩選特定空間內的頁面。
• 根據標題和空間鍵查找頁面，進一步精準定位。
• 創建新頁面（可選父頁面），靈活構建頁面層級。
• 更新現有頁面，及時維護頁面內容。
• 刪除頁面，清理不再需要的頁面。

📦 安裝指南

1. 克隆此倉庫。
2. 安裝依賴項：

pip install -r requirements.txt

🛠️ 配置說明

在項目根目錄中創建一個 .env 文件，包含以下變量：

CONFLUENCE_API_BASE=http://localhost:8090/rest/api
CONFLUENCE_USERNAME=your_username
CONFLUENCE_PASSWORD=your_password

請根據您的 Confluence 實例調整上述值。

💻 使用示例

運行服務器

開發模式（推薦）

運行 MCP 服務器的正確方式是使用 MCP CLI 工具以開發模式啟動。這將啟動 MCP 檢查器 UI，允許您測試和調試服務器：

mcp dev confluence.py

此方式將在默認情況下在 http://127.0.0.1:6274 啟動 MCP 檢查器。

直接執行（不推薦）

MCP 服務器設計為與 MCP CLI 工具或集成到 Claude Desktop 中運行。直接使用 Python 執行並不是運行 MCP 服務器的標準方式，但腳本包含測試的備用模式：

python confluence.py

然而，此模式功能有限，僅用於基本測試。

安裝在 Claude Desktop

要在 Claude Desktop 中安裝服務器：

mcp install confluence.py

📚 詳細文檔

API 參考

execute_cql_search

在 Confluence 上執行 CQL 查詢以搜索頁面。 參數：

• cql：CQL 查詢字符串
• limit：要返回的結果數量（默認：10）

get_page_content

獲取 Confluence 頁面的內容。 參數：

• pageId：Confluence 頁面 ID

get_page_with_body

獲取帶正文內容的頁面。 參數：

• pageId：Confluence 頁面 ID

find_pages_by_space

根據空間鍵查找頁面。 參數：

• spaceKey：Confluence 空間鍵
• limit：要返回的最大結果數（默認：10）
• expand：可選的逗號分隔的擴展屬性列表

find_page_by_title

根據標題和空間鍵查找頁面。 參數：

• title：頁面標題
• spaceKey：Confluence 空間鍵

create_page

在 Confluence 中創建新頁面。 參數：

• title：頁面標題
• spaceKey：Confluence 空間鍵
• content：頁面內容（HTML 格式）
• parentId：可選的父頁面 ID

update_page

更新現有頁面。 參數：

• pageId：Confluence 頁面 ID
• content：新頁面內容（HTML 格式）
• title：可選的新標題
• spaceKey：可選空間鍵（僅在更改空間時需要）

delete_page

刪除頁面。 參數：

• pageId：要刪除的頁面 ID