Confluence MCP Server K7o

🚀 Confluence MCP サーバー

Atlassian Confluence 用の Model Context Protocol (MCP) サーバーの実装です。このサーバーは、MCP プロトコルを通じて Confluence とやり取りする一連のツールを提供し、AI エージェントが Confluence のコンテンツをシームレスに処理できるようにします。Flask で構築されており、Cloud Run へのデプロイが容易です。

✨ 主な機能

• Confluence クエリ言語（CQL）を使用したページとスペースの検索
• 利用可能なすべての Confluence スペースの一覧表示
• Confluence ページの作成、読み取り、更新、削除
• 豊富な Confluence リソースのメタデータサポート
• Flask ベースのサーバーで、Cloud Run デプロイに適しています
• MCP ツールを備え、AI エージェントの統合が容易です

📦 インストール

1. リポジトリをクローンします。
2. 依存関係をインストールします。

pip install -r requirements.txt

📚 ドキュメント

設定

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の変数を追加します。

CONFLUENCE_URL=https://your-instance.atlassian.net/wiki
CONFLUENCE_ACCESS_TOKEN=your_access_token
PORT=8080  # オプション、デフォルトは 8080

アクセストークンを取得する方法：

1. Atlassian アカウントにログインします。
2. Account Settings > Security > Create and manage API tokens に移動します。
3. 新しい API トークンを作成し、コピーします。

利用可能なツール

サーバーは以下の MCP ツールを提供します。

基本的な使用法

# 1. コンテンツを検索する
@tool("search_confluence")
def search(query: str) -> Dict[str, Any]

# 2. スペースを取得する
@tool("get_spaces")
def get_spaces() -> Dict[str, Any]

# 3. ページの内容を取得する
@tool("get_page_content")
def get_page_content(space_key: str, page_id: str) -> Dict[str, Any]

# 4. ページを作成する
@tool("create_page")
def create_page(space_key: str, title: str, content: str) -> Dict[str, Any]

# 5. ページを更新する
@tool("update_page")
def update_page(space_key: str, page_id: str, content: str) -> Dict[str, Any]

# 6. ページを削除する
@tool("delete_page")
def delete_page(space_key: str, page_id: str) -> Dict[str, Any]

ローカルでの実行

サーバーをローカルで実行するには、以下のコマンドを実行します。

python example.py

サーバーは http://localhost:8080 で起動します。

Cloud Run へのデプロイ

1. Docker イメージをビルドします。

docker build -t confluence-mcp .

2. タグを付けて Google Container Registry にプッシュします。

docker tag confluence-mcp gcr.io/[PROJECT-ID]/confluence-mcp
docker push gcr.io/[PROJECT-ID]/confluence-mcp

3. Cloud Run にデプロイします。

gcloud run deploy confluence-mcp \
  --image gcr.io/[PROJECT-ID]/confluence-mcp \
  --platform managed \
  --allow-unauthenticated \
  --set-env-vars="CONFLUENCE_URL=[YOUR_URL],CONFLUENCE_ACCESS_TOKEN=[YOUR_TOKEN]"

エラー処理

すべてのツールには適切なエラー処理が含まれており、形式が正しいエラーメッセージが返されます。応答形式は以下の通りです。

• 成功時：指定された形式の関連データ
• エラー時：{"error": "エラーメッセージ"}

セキュリティに関する注意事項

1. 常に環境変数を使用して機密データを保存します。
2. Cloud Run の組み込みキー管理機能の使用を検討します。
3. エンドポイントに適切な認証を実装します。
4. Confluence アクセストークンの安全性を確保します。

コントリビューションガイド

コントリビューションを歓迎します！開発への参加方法については、プロジェクトドキュメントを参照してください。

📄 ライセンス

このプロジェクトは [LICENSE] ライセンスに準拠しています。