Repo Context Mcp

Repo Context MCP 🚀

コードリポジトリをローカルでもリモートでも、VS Code から直接調査・分析できます。

---

🚀 Repo-context-mcp を使う理由

VS Code でこのツールを使わない場合と使う場合の違いをご覧ください。

	❌ Repo-context-mcp を使わない場合	✅ Repo-context-mcp を使う場合
🔍 リポジトリ構造の調査	ファイルやフォルダーを手動で閲覧する	任意のリポジトリ内のファイルやフォルダーをすぐに一覧表示する
📄 ファイル内容の読み取り	ファイルを1つずつ開く	1つのコマンドで任意のファイルの内容を読み取る
🧑‍💻 コード分析	関数を手動で確認・エクスポートする	エクスポートされた関数と型を自動的に取得する
🔒 プライベート／パブリックリポジトリ	ローカルにクローンしてセットアップする必要がある	ローカルまたはリモート（プライベートリポジトリも含む）を分析する
⚡ GitHub エンドポイント	API の手動呼び出しやクローンが必要	クローンせずにファイルとメタデータを取得する

---

✨ 機能

• 📂 任意のリポジトリ（ローカルまたは GitHub）のファイルとフォルダーを一覧表示
• 📄 ファイル内容をすぐに読み取り
• 🧑‍💻 TypeScript／JavaScript ファイルのエクスポートされた関数と型を分析
• 🔒 プライベートリポジトリとパブリックリポジトリに対応
• ⚡ クローンは不要：GitHub エンドポイントからファイルとメタデータを取得

---

🛠️ インストール

1. VS Code にインストールする

   ワークスペースを開き、次を実行します。

   npm install
   

2. プロジェクトをビルドする

   npm run build
   

3. 開発モードでサーバーを起動する

   npm run start:dev
   

   または、コンパイル済みコードを実行するには、次を実行します。

   npm start
   

---

🚦 仕組み

この MCP サーバーを使うと、次のことができます。

• 分析するリポジトリのパスを設定する（ローカルまたはリモート）
• ファイルとフォルダーを一覧表示する
• ファイル内容を読み取る
• TypeScript／JavaScript ファイルを分析して、エクスポートされた関数とその型情報を抽出する

これらのツールはすべて VS Code から直接利用できるため、作業しながらコードベースを簡単に理解し、ドキュメント化できます。

---

🎯 例：エンドポイントが要求する内容をすぐに見つける

Repo Context MCP を使うと、TypeScript リポジトリを分析し、API エンドポイントについて、リクエストを成功させるために送信すべきオブジェクトや型など、具体的な質問をすることができます。

たとえば：

「新しいユーザーを作成するには、POST /users/register に何を送信すればよいですか？」

Repo Context MCP はソースコードを分析し、列挙型やネストされたオブジェクトを含む、必要な正確な JSON 構造と TypeScript の型を提示します。
そのため、推測したりドキュメントを探したりする時間をかけずに、送信すべき内容を正確に把握できます。

開発者の生産性を大幅に向上させます。

• エンドポイントのペイロードと型をすぐに確認できる
• 試行錯誤やリクエストの失敗を避けられる
• プライベート API を含むあらゆるバックエンドとの連携を迅速化できる

具体例が必要な場合や、任意のエンドポイントのペイロードを確認したい場合は、尋ねるだけで Repo Context MCP が直接抽出します。

---

🔗 連携

この MCP サーバーをコンテキストプロバイダーとして mcp.json に登録します。

{
  "servers": {
    "repo-context-mcp": {
      "command": "npx",
      "args": [
        "ts-node",
        "/home/pablo/Apps/repo-context/src/index.ts"
      ],
      "type": "stdio",
      "env": {
        "ENVIRONMENT": "local",
        "GITHUB_TOKEN": "",
        "GITHUB_NAME": ""
      }
    }
  }
}

---

🔒 プライベートリポジトリとローカルリポジトリの分析

• ローカルリポジトリ：setRepoPath ツールを使ってパスを設定します。

• プライベート GitHub リポジトリ：MCP サーバーの設定（mcp.json）にある環境変数に、GitHub のユーザー名とトークンを追加します。

  "env": {
    "GITHUB_TOKEN": "<your-github-token>",
    "GITHUB_NAME": "<your-github-username>"
  }
  

  その後、リポジトリの所有者、名前、ファイルパスを指定してツールを使い、プライベートリポジトリからファイルを取得・分析します。

注： プライベート GitHub リポジトリでは、設定に GitHub の認証情報を入力してください。ローカルリポジトリでは、ローカルパスを指定するだけです。

---

📦 要件

• Node.js 18+
• npm

---

💡 メモ

• setRepoPath ツールを使って、分析対象のリポジトリを動的に設定できます。
• サーバーはファイルの調査と型分析のためのツールを提供するため、コードの理解やドキュメント作成に最適です。
• クローンせずに、GitHub エンドポイントからファイルとメタデータを取得できます