GitHub Code Explorer using Model Context Protocol

Model Context Protocol を使用した GitHub コードエクスプローラー

このプロジェクトでは、AI アシスタントが利用できる GitHub コード検索ツールを作成するために、Model Context Protocol（MCP）を実装する方法を紹介します。

Model Context Protocol とは？

Model Context Protocol は、AI モデルが外部のツールやサービスとやり取りするための標準化された方法です。次の内容を定義します。

1. AI モデルに関数をどのように記述するか
2. AI モデルが呼び出す関数をどのように決定するか
3. パラメーターをどのように構成し、検証するか
4. 結果を一貫した形式でどのように返すか

機能

• GitHub リポジトリ全体からコードを検索
• リポジトリのファイル内容を表示
• GitHub リポジトリを検索
• 関数の検出エンドポイント
• AI アシスタントのシミュレーションインターフェース

インストール

1. このリポジトリをクローンします
2. 依存関係をインストールします。

   npm install
   

3. 任意：レート制限を緩和するには、GitHub API トークンを環境変数 GH_TOKEN として設定します

使用方法

1. サーバーを起動します。

   npm start
   

   または、自動リロードを有効にして開発モードで起動します。

   npm run dev
   

2. ブラウザーを開き、http://localhost:3000 にアクセスします

3. 「利用可能な関数を読み込む」をクリックして、API の機能を確認します

4. 入力ボックスにクエリを入力し、Enter キーを押して AI との会話をシミュレートします

API エンドポイント

• GET /api/mcp/functions - 利用可能なすべての関数を一覧表示します
• POST /api/mcp - パラメーターを指定して関数を呼び出します

実装の詳細

このアプリケーションは、次の要素で構成されています。

• GitHub API をラップする Node.js/Express バックエンド
• API を使用して AI アシスタントをシミュレートするブラウザークライアント
• JSON Schema を使用した MCP 互換の関数定義