Confluence Cloud MCP

🚀 Confluence Cloud MCP サーバー

Confluence Cloud とのインタラクションツールを提供する Model Context Protocol (MCP) サーバーです。このサーバーにより、AI アシスタントは統一されたインターフェースを通じて Confluence のスペース、ページ、コンテンツを管理できます。

✨ 主な機能

• スペース管理
  • すべてのスペースを一覧表示
  • 特定のスペースの詳細情報を取得
• ページ操作
  • ページの作成、読み取り、更新
  • 特定のスペース内のページを一覧表示
  • 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