Confluence MCP Server

Confluence Cloud MCP サーバー

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

特徴

• スペース管理
  • スペースをリストする
  • スペースの詳細を取得する
• ページ操作
  • ページの作成、閲覧、更新
  • スペース内のページを一覧表示する
  • Confluence のストレージ形式���ら Markdown にページコンテンツを変換する
• 検索とラベル
  • CQL を使用してコンテンツを検索する
  • ページラベルを管理する

設定

オプション 1: Docker を使用する (推奨)

このサーバーを使用する最も簡単な方法は、事前に構築された Docker イメージを使用することです。

オプション2: ローカルで構築する

1. リポジトリをクローンします。

2. ローカル ビルド スクリプトを使用してビルドおよび実行します。

オプション3: ソースから

1. 依存関係をインストールします:

2. 環境変数を設定する: Confluence の資格情報を使用して.envファイルを作成します。

3. プロジェクトをビルドします。

4. サーバーを実行します。

使用法

サーバーを MCP 構成に追加することで、MCP 対応の AI アシスタントと統合できます。

AI アシスタント向けの注意: Cline のような AI アシスタントがこの MCP サーバーをインストールしようとしている場合は、詳細なインストール手順についてはllms-install.mdファイルを参照してください。

利用可能なツール

宇宙ツール

• list_confluence_spaces : Confluence 内のすべてのスペースを一覧表示します
• get_confluence_space : 特定のスペースの詳細を取得する

ページツール

• list_confluence_pages : スペース内のページを一覧表示する
• get_confluence_page : 特定のページとそのコンテンツを取得します（Markdown 変換が含まれるようになりました）
• create_confluence_page : スペースに新しいページを作成する
• update_confluence_page : 既存のページを更新する

get_confluence_pageツールは、Confluence ストレージ形式のコンテンツを Markdown に自動変換するようになりました。これにより、ページコンテンツの操作が容易になります。この変換処理では、以下の処理が行われます。

• ヘッダー（h1-h6）
• リスト（順序付きと順序なし）
• リンク
• 強調（太字/斜体）
• コードブロック
• テーブル
• 段落と改行

検索とラベルツール

• search_confluence_pages : CQL を使用して Confluence コンテンツを検索する
• get_confluence_labels : ページのラベルを取得する
• add_confluence_label : ページにラベルを追加する
• remove_confluence_label : ページからラベルを削除する

注: すべてのツール名は、一貫性と明確さを保つために [動詞]合流[名詞] の命名規則に従います。

発達

このプロジェクトはTypeScriptで記述されており、サーバー機能を実装するためのMCP SDK規約に準拠しています。コードベースは以下のとおりです。

• src/client/ - Confluence API クライアント実装
• src/handlers/ - MCP ツールリクエストハンドラー
• src/schemas/ - ツール入力用のJSONスキーマ
• src/types/ - TypeScript 型定義
• src/utils/ - コンテンツ形式の変換を含むユーティリティ関数

CI/CDパイプライン

このプロジェクトでは、継続的な統合とデプロイメントに GitHub Actions を使用します。

• プルリクエストの自動テストとリンティング
• メインブランチのコミット時に Docker イメージを自動ビルド
• マルチアーキテクチャ イメージ ビルド (amd64、arm64)
• GitHub Container Registryへのコンテナ公開

地域開発

ローカル開発の場合は、提供されているスクリプトを使用します。

• ./scripts/build-local.sh : プロジェクトをビルドし、ローカル Docker イメージを作成します
• ./scripts/run-local.sh : 資格情報を使用してローカルの Docker イメージを実行します

ライセンス

マサチューセッツ工科大学