Awesome Copilot MCP Server

Awesome Copilot MCP Server

awesome-copilot のエージェントとコレクションのリソースにアクセスできる Model Context Protocol（MCP）サーバーです。

クイックスタート

VS Code へのワンクリックインストール

バッジをクリックすると、VS Code に直接インストールできます（VS Code を開くかどうかを確認するプロンプトが表示されます）。

注記： VS Code に GitHub Copilot 拡張機能が必要です。GitHub 上のバッジをクリックすると、インストール確認のプロンプトが表示されます。

手動設定

MCP クライアントの設定に追加します（例：Claude Desktop または VS Code）。

{
  "mcpServers": {
    "awesome-copilot": {
      "command": "npx",
      "args": ["-y", "awesome-copilot-mcp", "start"]
    }
  }
}

これにより、常に最新バージョンを実行できます。

使用方法

MCP サーバーとして

標準の stdio で使用します（デフォルト）。上記の設定を参照してください。

HTTP / OpenAPI サーバーとして

リモートアクセスまたは OpenAPI のテスト用に、ローカルで実行します。

npx -y awesome-copilot-mcp start-http --port 8080 --host 0.0.0.0

利用可能なエンドポイント：

• GET /health ヘルスチェック
• GET /metadata メタデータインデックスを返します
• GET /metadata/stream メタデータを SSE でストリーミング出力します
• GET /search?q=kw 検索
• GET /openapi.json API ドキュメント

サポートするコンテンツタイプ

このサーバーは、公式の github/awesome-copilot リポジトリで公開されているすべてのリソースをインデックス化します。

• 🤖 エージェント
• 💬 プロンプト
• 📋 指示
• 🛠️ スキル（フォルダーを認識）
• 📦 コレクション
• 🎁 プラグイン（plugins/external.json から）
• 🪝 フック
• ⚡ エージェント型ワークフロー

デバッグ

テストとデバッグには、MCP Inspector の使用を推奨します。

# Debug via Stdio (Recommended)
npx -y awesome-copilot-mcp debug --no-build

# Debug via HTTP
npm run inspect:http

アーキテクチャ

このサーバーは、信頼性を最大限に高めるため、バンドル＋インメモリアーキテクチャを採用しています。

1. 起動時：npm パッケージに直接バンドルされた metadata.json を読み込みます。外部依存関係はありません。
2. ホットアップデート：refresh_metadata が GitHub から最新データを取得し、現在のセッション用にメモリに保存します。
3. サンドボックス対応：ローカルのディスクキャッシュ（~/.cache）を使用しないため、制限された環境（macOS App Sandbox など）での権限の問題を防げます。

環境変数

変数	説明
ACP_METADATA_URL	任意。ホストされた metadata.json の URL（例：https://yourname.github.io/repo/metadata.json）。GitHub の raw fetch より優先されます。
ACP_REPOS_JSON	カスタムリポジトリ設定 JSON。

メタデータの生成

自動処理：GitHub Actions が毎日実行され、github/awesome-copilot から最新のメタデータを取得します。変更が検出されると、新しい npm バージョンを公開します。

内部処理： メタデータファイルは軽量（約 170 KB）で、インデックス情報のみを含みます。エージェント、プロンプト、指示、スキル、コレクション、プラグイン、フック、ワークフローの実際のコンテンツとダウンロード先は、公開されているツールとリソースを通じて必要に応じて解決されます。

開発

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

ライセンス

MIT