Confluence Cloud MCP サーバー

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

特徴

• スペース管理

  • スペースをリストする

  • スペースの詳細を取得する

• ページ操作

  • ページの作成、閲覧、更新

  • スペース内のページを一覧表示する

  • Confluence のストレージ形式から Markdown にページコンテンツを変換する

• 検索とラベル

  • CQL を使用してコンテンツを検索する

  • ページラベルを管理する

Related MCP server: Confluence MCP Server

設定

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

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

docker run --rm -i \
  -e CONFLUENCE_API_TOKEN=your-api-token \
  -e CONFLUENCE_EMAIL=your-email@domain.com \
  -e CONFLUENCE_DOMAIN=your-domain.atlassian.net \
  ghcr.io/aaronsb/confluence-cloud-mcp:latest

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

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

git clone https://github.com/aaronsb/confluence-cloud-mcp.git
cd confluence-cloud-mcp

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

# Build the Docker image
./scripts/build-local.sh

# Run the server
CONFLUENCE_API_TOKEN=your-token CONFLUENCE_EMAIL=your-email ./scripts/run-local.sh

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

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

npm install

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

CONFLUENCE_DOMAIN=your-domain.atlassian.net
CONFLUENCE_EMAIL=your-email@domain.com
CONFLUENCE_API_TOKEN=your-api-token

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

npm run build

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

node build/index.js

使用法

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

{
  "mcpServers": {
    "confluence": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/aaronsb/confluence-cloud-mcp:latest"],
      "env": {
        "CONFLUENCE_DOMAIN": "your-domain.atlassian.net",
        "CONFLUENCE_EMAIL": "your-email@domain.com",
        "CONFLUENCE_API_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

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 イメージを実行します

ライセンス

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