MCP Server Atlassian Confluence

🚀 Atlassian Confluence MCP サーバー

このプロジェクトは、モデルコンテキストプロトコル（MCP）サーバーを提供します。これは、人工知能アシスタント（Anthropic の Claude、Cursor AI などの MCP 互換クライアント）と Atlassian Confluence インスタンスの間の橋渡し役となります。これにより、AI が安全にリアルタイムで Confluence のスペースやページにアクセスし、やり取りすることができます。

🚀 クイックスタート

インストールと実行

1. npm を通じてグローバルにコマンドラインツールをインストールする

npm install -g @aashari/mcp-server-atlassian-confluence

2. コマンドの使用例

mcp-atlassian-confluence --help
# 利用可能なすべてのコマンドとそのオプションを表示

mcp-atlassian-confluence list-spaces
# すべての Confluence スペースをリストする

mcp-atlassian-confluence get-page --page-id 12345678
# 指定されたページの内容を取得する

設定ガイド

ステップ 1: 依存関係のインストール

npm install @aashari/mcp-server-atlassian-confluence

ステップ 2: サーバーの起動

npx @aashari/mcp-server-atlassian-confluence start

✨ 主な機能

なぜこのサーバーを使用するのか？

• 最小限の入力で最大限の出力：spaceKey や pageId のような単純な識別子だけで済みます。各ツールは追加のフラグなしで全面的な詳細情報を返します。
• 完全な知識ベースへのアクセス：AI アシスタントにドキュメント、ウィキ、知識ベースの内容に対する完全な可視性を提供し、リアルタイムで利用可能です。
• 充実したフォーマット付きコンテンツ：すべてのページコンテンツは、Atlassian ドキュメント形式から Markdown に自動変換され、適切な見出し、表、リスト、その他のフォーマット要素が含まれます。
• 安全なローカル認証：資格情報はサーバーに保存されません。サーバーはローカルで実行されるため、トークンはデバイスを離れることはなく、必要な権限を要求できます。
• 直感的な Markdown コンテンツ：すべてのページコンテンツは、読みやすく編集しやすい Markdown 形式で返されます。

📦 インストール

コマンドラインツールのグローバルインストール

npm install -g @aashari/mcp-server-atlassian-confluence

依存関係のインストール

npm install @aashari/mcp-server-atlassian-confluence

💻 使用例

基本的な使用法

# すべての Confluence スペースをリストする
mcp-atlassian-confluence list-spaces

高度な使用法

# CQL を使用して Confluence のコンテンツを検索する
mcp-atlassian-confluence search --cql "text ~ 'project plan'"

📚 ドキュメント

概要

何が MCP ですか？

モデルコンテキストプロトコル（MCP）は、人工知能システムが外部のツールやデータソースに安全かつコンテキストに関連付けて接続できるようにするオープン標準です。

このサーバーは、Confluence Cloud 向けに MCP を実装し、Confluence のデータと AI アシスタントを橋渡しします。

コマンドラインインターフェース（CLI）

npx を使用した即時実行

npx -y @aashari/mcp-server-atlassian-confluence list-spaces
npx -y @aashari/mcp-server-atlassian-confluence get-page --page 12345678

グローバルインストール後の使用

mcp-atlassian-confluence list-spaces
# すべての Confluence スペースをリストする

ツールインターフェース（API）

1. list-spaces

すべての利用可能な Confluence スペースをリストします。

{
  "spaces": [
    {
      "id": "123456",
      "key": "MySpaceKey",
      "name": "My Space Name"
    }
  ]
}

2. get-page

指定されたページの内容を取得します。

mcp-atlassian-confluence get-page --page-id 12345678

返却結果：

{
  "id": "12345678",
  "title": "My Page Title",
  "content": "# My Page Heading\nThis is the content of my page."
}

3. search

CQL を使用して Confluence のコンテンツを検索します。

mcp-atlassian-confluence search --cql "text ~ 'project plan'"

返却結果：

{
  "results": [
    {
      "id": "12345679",
      "title": "Project Plan Document",
      "content": "This document outlines our project plan for Q3."
    }
  ]
}

📄 ライセンス

ISC License