Confluence Cloud MCP

🚀 Confluence Cloud MCP 服務器

Confluence Cloud MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它提供了與 Confluence Cloud 交互的工具。藉助該服務器，AI 助手能夠通過統一接口對 Confluence 空間、頁面和內容進行管理。

🚀 快速開始

將此服務器集成到支持 MCP 的 AI 助手中，只需在它們的 MCP 配置中添加即可：

{
  "servers": {
    "confluence-cloud-mcp": {
      "url": "http://localhost:3000",
      "type": "mcp"
    }
  }
}

✨ 主要特性

• 空間管理
  • 列出所有空間
  • 獲取特定空間的詳細信息
• 頁面操作
  • 創建、讀取、更新頁面
  • 列出特定空間中的頁面
  • 將 Confluence 存儲格式內容轉換為 Markdown
• 搜索與標籤
  • 使用 CQL 搜索內容
  • 管理頁面標籤

📦 安裝指南

選項1：使用 Docker（推薦）

最簡單的方式是使用預構建的 Docker 鏡像：

docker run --rm -i \
  -e CONFLUENCE_API_TOKEN=your-api-token \
  -e CONFLUENCE_EMAIL=your-email@domain.com \
  -e CONFLUENCE_DOMAIN=your-domain.atlassian.net \
  ghcr.io/aaronsb/confluence-cloud-mcp:latest

選項2：本地構建

1. 克隆倉庫：

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

2. 使用本地構建腳本運行：

# 構建 Docker 鏡像
./scripts/build-local.sh

# 運行服務器
CONFLUENCE_API_TOKEN=your-token CONFLUENCE_EMAIL=your-email ./scripts/run-local.sh

選項3：從源代碼構建

1. 安裝依賴：

npm install

2. 配置環境變量： 創建一個 .env 文件，添加你的 Confluence 憑據：

CONFLUENCE_DOMAIN=your-domain.atlassian.net
CONFLUENCE_EMAIL=your-email@domain.com
CONFLUENCE_API_TOKEN=your-api-token

3. 構建項目：

npm run build

4. 運行服務器：

node build/index.js

💻 使用示例

基礎用法

將此服務器集成到支持 MCP 的 AI 助手中，只需在它們的 MCP 配置中添加即可：

{
  "servers": {
    "confluence-cloud-mcp": {
      "url": "http://localhost:3000",
      "type": "mcp"
    }
  }
}

📚 詳細文檔

可用工具

• 配置管理
  • configure: 配置 MCP 服務器
  • get-config: 獲取當前配置
  • update-config: 更新現有配置
• 認證管理
  • auth/login: 用戶登錄
  • auth/logout: 用戶註銷
  • auth/status: 檢查認證狀態

🔧 技術細節

CI/CD 管道

項目使用 GitHub Actions 實現持續集成和交付：

• 提交請求時自動運行測試和代碼檢查
• 主分支提交自動構建 Docker 鏡像
• 多架構鏡像構建（amd64, arm64）
• 自動將容器推送到 GitHub Container Registry

本地開發

使用提供的腳本進行本地開發：

• ./scripts/build-local.sh: 構建項目並生成本地 Docker 鏡像
• ./scripts/run-local.sh: 運行本地 Docker 鏡像，並配置你的憑據

📄 許可證

MIT