Confluence MCP Server

Confluence MCP サーバー

REST API を介して Confluence Data Center とやり取りするための Model Context Protocol（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 Inspector UI が起動します。

mcp dev confluence.py

デフォルトでは、MCP Inspector は http://127.0.0.1:6274 で起動します。

直接実行（非推奨）

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

Confluence の既存のページを更新します。

パラメーター：

• pageId：Confluence のページ ID
• content：ストレージ形式（HTML）の新しいページコンテンツ
• title：ページの新しいタイトル（省略可能）
• spaceKey：スペースキー（省略可能。スペースを変更する場合にのみ必要）

delete_page

ID を指定してページを削除します。

パラメーター：

• pageId：Confluence のページ ID

使用例

サーバーが起動し、AI モデルに接続されると、自然言語を使って Confluence とやり取りできます。たとえば、次のように指示できます。

• 「DOCS スペースにあるすべてのページを検索して」
• 「ID 123456 のページのコンテンツを取得して」
• 「TEAM スペースに、「Meeting Notes」というタイトルで、コンテンツが「

  Notes from our meeting

  」の新しいページを作成して」
• 「ID 123456 のページのコンテンツを「

  Updated meeting notes

  」に更新して」
• 「ページ 123456 のタイトルを「Revised Meeting Notes」に変更して」

ライセンス

MIT