Master MCP Server

🚀 Master MCP Server

Master MCP Serverは、複数のMCPサーバーを1つの安全なエンドポイントの背後に集約します。設定駆動型のモジュール読み込み、統一された機能検出、回復力のあるリクエストルーティング、およびマルチバックエンド認証のための一流のOAuthフローを提供します。

✨ 主な機能

• ツール/リソースの検出と名前空間を備えた複数のMCPサーバーの集約
• OAuthサポート: マスタートークンの透過、委任されたプロバイダーフロー、プロキシの更新
• JSON/YAMLによる設定駆動型のセットアップ、スキーマ検証、およびシークレットの解決
• 回復力のあるルーティング: ロードバランシング、バックオフ/ジッターを伴うリトライ、サーキットブレーカー
• クロスプラットフォーム: Node.jsサーバーとCloudflare Workersランタイム
• 本番環境でのデプロイ準備: Docker、Cloudflare Workers、Koyeb
• テスト戦略とCI対応の構造

🚀 クイックスタート (Node.js)

1. 依存関係をインストールします (ネットワークが必要です):

npm ci

2. 環境を設定します (コピーして編集します):

cp .env.example .env

3. 開発モードで実行します:

npm run dev

4. ヘルスチェックとメトリクス:

• GET /health → { ok: true }
• GET /metrics → 基本的なシステムメトリクス

5. MCPエンドポイント (HTTPゲートウェイ):

• POST /mcp/tools/list
• { name, arguments } を含む POST /mcp/tools/call
• POST /mcp/resources/list
• { uri } を含む POST /mcp/resources/read

詳細ガイドとエンドツーエンドの例については、docs/ を参照してください。

📚 ドキュメント

• ドキュメントインデックス: docs/index.md
• 入門ガイド: docs/getting-started/overview.md
• ガイド: docs/guides/*
• APIリファレンス: docs/api/reference/ に生成されます (以下を参照)
• 設定リファレンス: docs/configuration/*
• デプロイ: docs/deployment/*
• トラブルシューティング: docs/troubleshooting/*
• コントリビュート: docs/contributing/*

APIドキュメントの生成

TypeScriptからAPIドキュメントを生成するために、TypeDoc (Markdown) を使用しています。

1. インストールします (ネットワークが必要です):

npm i -D typedoc typedoc-plugin-markdown

2. ドキュメントを生成します:

npm run docs:api

docs/api/ に出力されます。

💻 使用例

実際の使用例は examples/ にあります:

• 基本的なNode: examples/basic-node
• Cloudflare Worker: examples/cloudflare-worker
• 高度なルーティング: examples/advanced-routing
• OAuth委任: examples/oauth-delegation
• テストパターン: /tests と docs/examples/testing.md を参照

各例には、実行手順が記載されたREADMEがあります。

デプロイ

• Docker: deploy/docker/* とトップレベルの Dockerfile / docker-compose.yml
• Cloudflare Workers: deploy/cloudflare/* と wrangler.toml
• Koyeb: deploy/koyeb/koyeb.yaml
• CI/CDの例: docs/deployment/cicd.md を参照

🔧 技術詳細

コントリビュートとサポート

• 開発ワークフローとガイドラインについては、docs/contributing/* を参照してください。
• 解決策については、docs/troubleshooting/index.md を参照してください。
• ヘルプやアイデアについては、issueまたはdiscussionを開いてください。

📄 ライセンス

LICENSE を参照してください。このリポジトリは現在、プライベート/内部使用のためにUNLICENSEDを使用しています。