Confluence MCP サーバー

REST APIを介してConfluence Data Centerと連携するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、AIモデルがConfluenceコンテンツと連携するためのツールセットを提供します。

特徴

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

• CQL (Confluence クエリ言語) 検索を実行する

• IDでページコンテンツを取得する

• 本文を含むページコンテンツを取得する

• スペースキーでページを検索

• タイトルとスペースキーでページを検索

• 新しいページを作成する（オプションで親ページを追加）

• 既存のページを更新する

• ページを削除する

Related MCP server: OmniMCP

インストール

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

これにより、デフォルトでhttp://127.0.0.1:6274で MCP Inspector が起動します。

直接実行（非推奨）

MCPサーバーは、MCP CLIツール、またはClaude Desktopと統合して実行するように設計されています。Pythonで直接実行することはMCPサーバーを実行する標準的な方法ではありませんが、スクリプトにはテスト用のフォールバックモードが含まれています。

python confluence.py

ただし、このモードは機能が制限されており、基本的なテストのみを目的としています。

Claude Desktopへのインストール

Claude Desktop にサーバーをインストールするには:

mcp install confluence.py

APIリファレンス

実行cql検索

Confluence で CQL クエリを実行してページを検索します。

パラメータ:

• cql : CQLクエリ文字列

• limit : 返される結果の数（デフォルト: 10）

ページコンテンツを取得する

Confluence ページのコンテンツを取得します。

パラメータ:

• pageId : Confluence ページ ID

get_page_with_body

本文コンテンツを含むページを取得します。

パラメータ:

• pageId : Confluence ページ ID

スペースでページを検索

スペースキーでページを検索します。

パラメータ:

• spaceKey : Confluence スペースキー

• limit : 返される結果の最大数（デフォルト: 10）

• expand : 展開するプロパティのオプションのカンマ区切りリスト

タイトルでページを探す

タイトルとスペースキーでページを検索します。

パラメータ:

• title : ページタイトル

• spaceKey : Confluence スペースキー

ページを作成

Confluence に新しいページを作成します。

パラメータ:

• title : ページタイトル

• spaceKey : Confluence スペースキー

• content : 保存形式 (HTML) のページコンテンツ

• parentId : オプションの親ページID

更新ページ

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

パラメータ:

• pageId : Confluence ページ ID

• content : 保存形式 (HTML) の新しいページコンテンツ

• title : ページの新しいタイトル（オプション）

• spaceKey : オプションのスペースキー（スペースを変更する場合のみ必要）

ページを削除

ID でページを削除します。

パラメータ:

• pageId : Confluence ページ ID

使用例

サーバーが稼働し、AIモデルに接続されると、自然言語を使ってConfluenceと対話できるようになります。例えば：

• 「DOCS スペース内のすべてのページを検索」

• 「ID 123456 のページの内容を取得する」

• 「TEAM スペースに「会議メモ」というタイトルの新しいページを作成し、コンテンツに「会議のメモ」を含めます」

• 「ID 123456 のページを更新して、「会議メモを更新しました」というコンテンツを追加します。」

• 「ページ 123456 のタイトルを「改訂版会議メモ」に更新します」

ライセンス

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