Confluence MCP

🚀 Confluence MCP サーバー

Confluence 用に設計されたモデルコンテキストプロトコル（MCP）サーバーです。これにより、AI アシスタントは標準化されたインターフェースを介して Confluence のコンテンツとやり取りすることができます。

ℹ️ Jira 用の 独立した MCP サーバー もあります。

🚀 クイックスタート

Confluence MCP サーバーは、AI アシスタントが Confluence コンテンツとやり取りできるようにするためのサーバーです。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• 個人の API トークンを使用した認証
• Confluence のページとスペースの検索と取得
• Confluence コンテンツの作成と更新
• ページのコメントの取得と追加
• ページの添付ファイルの取得と追加
• AI で使用するための Confluence コンテンツのクリーニングと変換
• API 通信、エラー処理、データ変換の処理
• API の乱用を防ぐための基本的なレート制限機能

📦 インストール

前提条件

• Bun (バージョン 1.0.0 以上)
• API アクセス権を持つ Confluence アカウント

インストール手順

# リポジトリをクローンする
git clone https://github.com/cosmix/confluence-mcp.git
cd confluence-mcp

# 依存関係をインストールする
bun install

# プロジェクトをビルドする
bun run build

📚 ドキュメント

設定

この MCP サーバーを使用するには、以下の環境変数を設定する必要があります。

CONFLUENCE_API_TOKEN=your_api_token
CONFLUENCE_BASE_URL=your_confluence_instance_url  # 例: https://your-domain.atlassian.net/wiki
CONFLUENCE_USER_EMAIL=your_email

Claude Desktop / Cline の設定

設定ファイルに以下の設定を追加してください。

{
  "mcpServers": {
    "confluence": {
      "command": "bun",
      "args": ["/absolute/path/to/confluence-mcp/dist/index.js"], 
      "config": {
        "developmentMode": true,
        "apiEndpoint": "http://localhost:3000"
      }
    }
  }
}

開発

# 開発モードで実行する
bun run dev

# テストを実行する
npm test

ツール

コンテンツの取得

ページの取得（get_page）

get_page({
  space: string, // スペース名、例: "MySpace"
  title: string   // ページタイトル、例: "HomePage"
}): Promise<Page>

コンテンツの検索（search_content）

search_content(query: string): Promise<SearchResult[]>

作成と更新

ページの作成（create_page）

create_page({
  space: string,
  title: string,
  content: string // CommonMark と HTML 形式をサポート
}): Promise<Page>

ページの更新（update_page）

update_page({
  id: string,
  version: number,
  content: string
}): Promise<void>

コンテンツの管理

ページの削除（delete_page）

delete_page(id: string, version?: number): Promise<void>

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。