Confluence MCP Server
Confluence APIにアクセスするためのModel Context Protocolサーバーシステム。 Personal Access Tokenを使用してConfluenceと通信します。 VPNゾーン内でConfluence APIにアクセスするための仲介サーバーとして機能します。
システム構成
このプロジェクトは2つのサーバーで構成されています。
- MCPサーバー（server.ts）：Confluence APIと通信してデータを処理するプライマリサーバー。
- デフォルトポート：3000
- RESTful APIの提供
- MCPプロトコル処理
- プロキシサーバー（ proxyServer.ts ）：MCPクライアントとMCPサーバー間のプロキシとして機能します。
- デフォルトポート：3001
- MCPクライアントから要求を受けてプライマリサーバーに転送
この構造は、VPNゾーンの問題を解決するために設計されています。 MCP サーバーは VPN 内で実行され、Confluence API にアクセスし、プロキシサーバーは外部からアクセス可能な環境で実行されます。
機能
- すべてのConfluenceスペースのリストを見る
- 特定のスペース内のすべてのページを検索する
- ページIDで特定のページ情報を検索する
- 新しいページを作成
- 既存のページを更新
インストールと設定
前提条件
- Node.js 16.x以降
- Bun 1.0.0以降
インストール
# 저장소 클론
git clone https://github.com/yourusername/confluence-mcp-server.git
cd confluence-mcp-server
# 의존성 설치
bun install
環境変数の設定
.envファイルをプロジェクトのルートに作成し、次の内容を追加します。
PORT=3000
PROXY_PORT=3001
MCP_SERVER_URL=http://localhost:3000
CONFLUENCE_BASE_URL=https://wiki.musinsa.com
PERSONAL_ACCESS_TOKEN=your_personal_access_token
NODE_ENV=development
実行
開発環境
# MCP 서버 실행 (Confluence API와 통신)
bun run dev
# 프록시 서버 실행 (MCP 클라이언트와 통신)
bun run dev:proxy
# MCP 서버 Stdio 모드 실행 (선택 사항)
bun run dev:stdio
本番環境
# 빌드
bun run build
# MCP 서버 실행
bun run serve
# 프록시 서버 실행
bun run serve:proxy
エンドポイント
MCPサーバーエンドポイント（デフォルトポート：3000）
- POST /mcp - MCP 要求を処理するメインエンドポイント
- GET /mcp/tools - 利用可能なツールのリストを検索する
- GET /api/spaces - すべてのスペースのリストを見る
- GET /api/spaces/:spaceKey/pages - 特定のスペースのページリストを検索する
- GET /api/pages/:pageId - 特定のページ情報の検索
- POST /api/pages - 新しいページの作成
- PUT /api/pages/:pageId - ページ更新
- GET /health - サーバーの状態を確認する
プロキシサーバーエンドポイント（デフォルトポート：3001）
- POST /mcp - MCP クライアント要求を受け取り、MCP サーバーに転送
- GET /tools - 利用可能なツールのリストを検索する
- GET /health - プロキシサーバーの状態を確認する
トラブルシューティング
VPNゾーンのトラブルシューティング
このプロジェクトは、VPNゾーンの問題を解決するために2つのサーバーに分けられています。
- MCPサーバーはVPN内で実行してConfluence APIに直接アクセスします。
- プロキシサーバーは外部からアクセス可能な環境で実行され、MCPクライアントからの要求を受け取ります。
この設定は、MCPクライアントが直接Confluence APIにアクセスできない状況で仲介として機能します。
"Error fetching spaces: Unable to connect" エラー
このエラーは、次の問題で発生する可能性があります。
- HTTPS 証明書の問題: 開発環境では SSL 証明書検証が無効になっていますが、本番環境では正しい証明書設定が必要です。
- ネットワーク接続の問題：ファイアウォールまたはプロキシ設定のためにConfluenceサーバーにアクセスできない場合。
- Personal Access Token 問題: トークンが期限切れになっているか、間違った形式になっている可能性があります。
解決策
.envファイルのCONFLUENCE_BASE_URLが正しいことを確認してください。- Personal Access Tokenが有効であることを確認してください。
- ファイアウォール設定を確認して、Confluenceサーバーにアクセスできることを確認します。
- ネットワーク管理者に連絡してアクセス権を確認してください。
- MCP サーバーとプロキシサーバー間の接続が正しく確立されていることを確認します (
MCP_SERVER_URLの設定).
テスト
# 모든 테스트 실행
bun test
# 특정 테스트 실행
bun test src/test/getSpaces.test.ts
展開の構成
推奨展開の構成
本番環境では、次の展開構成をお勧めします。
- MCPサーバー：VPN内部またはConfluenceサーバーにアクセスできるネットワークに展開
- プロキシサーバー：MCPクライアントがアクセス可能なネットワークに展開
セキュリティに関する考慮事項
- プロキシサーバーとMCPサーバー間の通信は、HTTPSを使用して暗号化することをお勧めします。
- Personal Access Tokenは安全に管理し、必要に応じて定期的に更新してください。
- 本番環境では、適切な認証メカニズムを追加して、プロキシサーバーへの不正なアクセスを防ぎます。
ライセンス
MIT