Confluence Data Center

🚀 Confluence MCP サーバー

Confluence Data Center とやり取りするためのモデルコンテキストプロトコル (MCP) サーバーです。このサーバーは、AI モデルが Confluence のコンテンツとやり取りできる一連のツールを提供します。

✨ 主な機能

この MCP サーバーは、Confluence に対して以下の操作を提供します。

• CQL（Confluence Query Language）検索を実行する
• 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