Atlassian Confluence Data Center MCP Server (Go)

Atlassian Confluence Data Center MCP サーバー（Go）

Atlassian Confluence Data Center エディションと連携する、Go 製の Model Context Protocol（MCP）サーバー実装です。このサーバーを使うと、AI アシスタントやその他の MCP クライアントから、Confluence のコンテンツをプログラムで読み取り、検索、作成、更新できます。

注：これは元の TypeScript 実装を Go で書き直したものです。このプロジェクトの着想となった元の実装を提供してくださった b1ff/atlassian-dc-mcp に感謝します。

機能

• 検索と取得：CQL（Confluence Query Language）を使ってコンテンツを検索し、ID でコンテンツを取得します
• コンテンツ管理：ページやブログ記事を新規作成し、既存のコンテンツを更新します
• スペース管理：Confluence のスペースを一覧表示および検索します
• 安全な認証：Bearer トークン認証に対応しています
• 高パフォーマンス：速度と効率性に優れた Go で構築されています
• 依存関係ゼロ：外部依存関係を最小限に抑え、可能な限り標準ライブラリを使用します

ツール

このサーバーは、次の MCP ツールを提供します。

confluence_get_content

Confluence Data Center エディションのインスタンスから、ID で Confluence コンテンツを取得します。

引数：

• contentId（string、必須）：Confluence Data Center のコンテンツ ID
• expand（string、任意）：展開するプロパティをカンマ区切りで指定したリスト

confluence_search_content

CQL を使って、Confluence Data Center エディションのインスタンス内のコンテンツを検索します。

引数：

• cql（string、必須）：Confluence Data Center 用の Confluence Query Language（CQL）検索文字列
• limit（number、任意）：返す結果の最大数（デフォルト：25）
• start（number、任意）：返す結果の開始インデックス
• expand（string、任意）：展開するプロパティをカンマ区切りで指定したリスト

confluence_create_content

Confluence Data Center エディションのインスタンスに新しいコンテンツを作成します。

引数：

• title（string、必須）：新しいコンテンツのタイトル
• spaceKey（string、必須）：コンテンツを作成するスペースのキー
• content（string、必須）：Confluence のストレージ形式で記述したページのコンテンツ
• type（string、任意）：コンテンツの種類（page または blogpost）
• parentId（string、任意）：親コンテンツの ID

confluence_update_content

Confluence Data Center エディションのインスタンス内の既存コンテンツを更新します。

引数：

• contentId（string、必須）：更新するコンテンツの ID
• version（number、任意）：新しいバージョン番号（デフォルトは現在のバージョン + 1）
• title（string、任意）：コンテンツの新しいタイトル
• content（string、任意）：ストレージ形式で記述した新しいコンテンツ
• versionComment（string、任意）：新しいバージョンについてのコメント

confluence_list_spaces

Confluence Data Center エディションのインスタンス内のスペースを一覧表示および検索します。

引数：

• searchText（string、任意）：スペース名または説明を検索するテキスト（省略すると、すべてのスペースを返します）
• limit（number、任意）：返すスペースの最大数
• start（number、任意）：返す結果の開始インデックス
• expand（string、任意）：展開するプロパティをカンマ区切りで指定したリスト

使用方法（MCP の設定）

どの方法を選べばよいか分からない場合：

• Go を使わない場合は、ビルド済みバイナリを使用してください
• Go 開発者の場合は、go installを使用してください

この MCP サーバーは、3 つの方法で使用できます。 インストール方法と実行方法に応じて、いずれか1 つを選択してください。

オプション 1：ビルド済みバイナリを使用する（Go を使わないユーザーにおすすめ）

インストール

リリースページ から適切なバイナリをダウンロードし、システム内の任意の場所（例：/usr/local/bin）に配置します。

chmod +x atlassian-confluence-dc-go-mcp

MCP の設定

{
  "mcpServers": {
    "confluence": {
      "command": "/usr/local/bin/atlassian-confluence-dc-go-mcp",
      "env": {
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "CONFLUENCE_BASE_URL": "https://confluence.example.com"
      }
    }
  }
}

オプション 2：go install を使用する（Go ユーザーにおすすめ）

インストール

go install github.com/anudeepd/atlassian-confluence-dc-go-mcp@latest

$GOBIN（または ~/go/bin）が PATH に含まれていることを確認してください。

export PATH="$HOME/go/bin:$PATH"

MCP の設定

バイナリが PATH 上にあるため、コマンド名だけを指定すれば十分です。

{
  "mcpServers": {
    "confluence": {
      "command": "atlassian-confluence-dc-go-mcp",
      "env": {
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "CONFLUENCE_BASE_URL": "https://confluence.example.com"
      }
    }
  }
}

オプション 3：ソースから実行する（開発／コントリビューション向け）

直接実行する

git clone https://github.com/anudeepd/atlassian-confluence-dc-go-mcp.git
cd atlassian-confluence-dc-go-mcp
go run .

MCP の設定（本番環境では非推奨）

{
  "mcpServers": {
    "confluence-dev": {
      "command": "go",
      "args": ["run", "."],
      "cwd": "/path/to/atlassian-confluence-dc-go-mcp",
      "env": {
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "CONFLUENCE_BASE_URL": "https://confluence.example.com"
      }
    }
  }
}

設定

サーバーには、次の環境変数が必要です。

必須の変数

• CONFLUENCE_API_TOKEN：Confluence API トークン（Bearer トークン）
• CONFLUENCE_BASE_URL：Confluence インスタンスのベース URL（例：https://confluence.example.com）

代替 URL 変数

CONFLUENCE_BASE_URL の代わりに、次のいずれかも使用できます。

• CONFLUENCE_API_BASE_PATH：完全な API パス
• CONFLUENCE_HOST：ホスト名のみ（先頭に https:// が付加されます）

ベース URL に /rest/api が含まれていない場合、サーバーが自動的に追加します。

設定例

export CONFLUENCE_API_TOKEN="your-api-token-here"
export CONFLUENCE_BASE_URL="https://confluence.example.com"

開発

テストの実行

# Run all tests
go test -v

# Run tests with coverage
go test -v -cover

# Generate coverage report
go test -coverprofile=coverage.out
go tool cover -html=coverage.out

ビルド

# Build for current platform
go build .

# Build for multiple platforms
./build.sh

build.sh スクリプトは、次のバイナリを作成します。

• Linux（amd64、arm64）
• macOS（amd64、arm64）
• Windows（amd64、arm64）

古い Go バージョンでのビルド

古いバージョンの Go（例：1.24）を使用しており、アップグレードできない場合は、go.mod ファイルを変更できます。

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

   git clone https://github.com/anudeepd/atlassian-confluence-dc-go-mcp.git
   cd atlassian-confluence-dc-go-mcp
   

2. go.mod の Go バージョンを編集します。

   go mod edit -go=1.24
   

3. モジュールを整理します。

   go mod tidy
   

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

   go build .
   

プロジェクト構成

.
├── main.go           # Main server implementation
├── main_test.go      # Comprehensive test suite
├── go.mod            # Go module dependencies
├── go.sum            # Dependency checksums
├── build.sh          # Multi-platform build script
└── README.md         # This file

API リファレンス

Confluence REST API

このサーバーは Confluence Data Center REST API v1 を使用します。API エンドポイントと CQL 構文の詳細については、次を参照してください。

• Confluence REST API ドキュメント
• Confluence Query Language（CQL）

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。詳細については LICENSE ファイルを参照してください。

謝辞

• TypeScript によるオリジナル実装：b1ff/atlassian-dc-mcp
• MCP Go SDK：mark3labs/mcp-go
• Model Context Protocol：Anthropic MCP

サポート

問題や質問、コントリビューションについては、GitHub で issue を作成してください。

変更履歴

v1.0.2

• 古い Go バージョンでのビルド手順を追加

v1.0.1 [Deprecated]

• go.mod のモジュールパスの誤りを修正
• 注：設定の問題により、このバージョンは非推奨です。v1.0.2 以降を使用してください。

v1.0.0（初回リリース）[Deprecated]

• TypeScript 実装を Go で全面的に書き直し
• Confluence のすべての主要な操作に対応
• マルチプラットフォームのビルドに対応
• MCP プロトコルに準拠
• 注：モジュール設定の誤りにより、このバージョンは非推奨です。v1.0.2 以降を使用してください。