Confluence

🚀 Confluence MCP 服務器

Confluence MCP 服務器是一個基於 FastMCP 的服務器，它能與 Confluence REST API 實現無縫集成，可讓用戶以程序化的方式訪問 Confluence 空間、頁面以及使用內容搜索功能。

🚀 快速開始

Confluence MCP 服務器可幫助你便捷地管理 Confluence 空間和頁面。你只需按照以下步驟操作，即可快速搭建並使用該服務器。

✨ 主要特性

• 空間管理：可以列出並篩選 Confluence 空間。
• 頁面操作：能夠檢索和管理頁面內容。
• 搜索功能：支持執行 CQL（Confluence 查詢語言）搜索。
• 空間導航：可列出特定空間中的所有頁面。
• 身份驗證：採用基於 API 令牌的安全訪問方式。

📦 安裝指南

使用 Smithery 自動安裝

通過 Smithery 為 Claude Desktop 自動安裝 confluence-mcp-server：

npx -y @smithery/cli install @MahithChigurupati/confluence-mcp-server --client claude

手動安裝

1. 克隆倉庫：

git clone https://github.com/yourusername/confluence-mcp.git
cd confluence-mcp

2. 安裝依賴項：

pip install -r requirements.txt

3. 啟動服務器：

python server.py

💻 使用示例

基礎用法

啟動服務器

python server.py

獲取空間列表

response = requests.get("http://localhost:5000/api/confluence/spaces")

創建新頁面

data = {
    "title": "New Page",
    "parent_id": "12345"
}
response = requests.post("http://localhost:5000/api/confluence/pages", json=data)

📚 詳細文檔

配置

1. 創建 .env 文件並添加以下內容：

CONFLUENCE_BASE_URL=your_confluence_url
USERNAME=your_atlassian_email
API_TOKEN=your_api_token

2. 環境變量示例：

export CONFLUENCE_BASE_URL="https://yourcompany.atlassian.net/wiki"
export USERNAME="user@example.com"
export API_TOKEN="your_api_token_here"

集成

Claude Desktop 配置示例：

{
    "server_url": "http://localhost:5000",
    "api_key": "your_api_key_here"
}

Cursor 配置示例：

{
    "confluence_server": "https://yourcompany.atlassian.net/wiki",
    "username": "user@example.com",
    "api_token": "your_api_token_here"
}

錯誤處理

常見錯誤代碼及其含義：

• 401：無效的 API 令牌或憑據。
• 403：權限不足。
• 404：資源未找到。
• 429：超出速率限制。

故障排除

1. 連接問題：
   • 驗證 CONFLUENCE_BASE_URL 格式。
   • 檢查網絡連通性。
   • 確認 API 令牌有效。
2. 身份驗證錯誤：
   • 確保 USERNAME 匹配 Atlassian 賬戶郵箱。
   • 驗證 API_TOKEN 正確粘貼。
   • 檢查 .env 文件中的特殊字符。
3. 權限問題：
   • 確認用戶具有所需的 Confluence 權限。
   • 驗證空間和頁面訪問權限。

📄 許可證

本項目採用 MIT License。詳見 LICENSE 文件以獲取完整條款。

支持

如需報告問題或功能請求，請在倉庫的問題跟蹤器中創建問題。

系統要求

• Python 3.8+
• pip（Python 包管理器）
• 帶有 API 訪問的有效 Confluence 實例
• 有效 Confluence API 令牌