Awesome Copilot MCP

🚀 Awesome Copilot MCP Server

このModel Context Protocol (MCP) サーバーは、awesome-copilot エージェントとコレクションリソースへのアクセスを提供します。

🚀 クイックスタート

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ドキュメント

🔧 デバッグ

MCP Inspectorを使用してテストとデバッグすることをおすすめします。

# Stdio経由でデバッグ（推奨）
npx -y awesome-copilot-mcp debug --no-build

# HTTP経由でデバッグ
npm run inspect:http

🔧 技術詳細

このサーバーは、最大限の信頼性を得るために Bundled + In-Memory アーキテクチャを使用しています。

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

📚 詳細ドキュメント

環境変数

メタデータ生成

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

内部: メタデータファイルは軽量（約170 KB）で、インデックス情報のみを含んでいます。実際のコンテンツ（エージェントの指示、プロンプト）は、download ツールを介して必要に応じて取得されます。

開発

# 依存関係のインストール
npm install

# ビルド
npm run build

# テストの実行
npm test

📄 ライセンス

MIT