Git Repo Browser

🚀 MCP Git リポジトリブラウザ (Node.js)

Model Context Protocol (MCP) の Node.js 実装を使用した Git リポジトリブラウザです。このブラウザは、Git リポジトリのディレクトリ構造を表示し、指定されたファイルの内容を読み取ることができます。

🚀 クイックスタート

このサーバーを使用するには、まず MCP 設定ファイルに設定を追加し、サーバーを起動する必要があります。以下に具体的な手順を示します。

📦 インストール

git clone <repository-url>
cd mcp-git-repo-browser
npm install

📚 ドキュメント

設定

以下の内容をあなたの MCP 設定ファイルに追加してください。

{
    "mcpServers": {
        "mcp-git-repo-browser": {
            "command": "node",
            "args": ["/path/to/mcp-git-repo-browser/src/index.js"]
        }
    }
}

機能

このサーバーは2つの主要なツールを提供します。

1. git_directory_structure：リポジトリのディレクトリ構造を木構造で返します。

   • 入力：リポジトリの URL
   • 出力：リポジトリのディレクトリ構造を示す ASCII 木構造

2. git_read_important_files：指定されたファイルの内容を読み取り、返します。

   • 入力：リポジトリの URL とファイルパスのリスト
   • 出力：ファイルパスから内容への辞書マッピング

使用方法

サーバーを起動するには、以下のコマンドを実行します。

node src/index.js

このサーバーは標準入出力で動作するため、MCP クライアントと互換性があります。

🔧 技術詳細

• Node.js の標準モジュール（crypto、path、os）を使用して、コア機能を実装しています。
• fs-extra を利用して、拡張されたファイル操作を行っています。
• simple-git を使用して、Git リポジトリの操作を行っています。
• きれいなエラー処理とリソースのクリーンアップを実装しています。
• リポジトリ URL のハッシュに基づいて、決定論的な一時ディレクトリを作成しています。
• 可能な限り、既にクローンされたリポジトリを再利用して、効率を向上させています。

要求

• Node.js 14.x 以上
• システムに Git がインストールされていること

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については LICENSE ファイルを参照してください。