MCP Git Explorer

🚀 MCP Git ブラウザ

簡単なMCP（モデルコンテキストプロトコル）サーバーです。リモートのGitリポジトリの内容を取得し、構造化されたテキスト形式で表示します。

✨ 主な機能

• Gitリポジトリのクローンと分析
• リポジトリ内容の構造化テキスト表現の生成
• すべての内容を取得せずに、コードベースのサイズとトークン数を迅速に推定
• パブリックリポジトリとトークン認証を使用するプライベートGitLabリポジトリのサポート
• OpenAIのtiktokenライブラリを使用したトークン化カウント
• .gitignoreと.repomixignoreパターンの尊重
• バイナリファイルと空のテキストファイルの無視
• Claudeのモデルコンテキストプロトコルとの統合

📦 インストール

PyPIからのインストール

pip install mcp-git-explorer

uvを使用したインストール

uv pip install mcp-git-explorer

インストールせずにuvxで直接実行

uvx mcp-git-explorer

💻 使用例

コマンドラインツールとして

# 基本的な使用法
mcp-git-explorer

# SSE転送を使用
mcp-git-explorer --transport sse

# GitLabトークンを提供
mcp-git-explorer --gitlab-token YOUR_TOKEN

環境変数

• GIT_EXPLORER_GITLAB_TOKEN：プライベートリポジトリにアクセスするためのGitLab個人用アクセストークン

Claudeでの使用

MCP GitブラウザはClaudeに以下の機能を付与します：

1. 手動でファイルをダウンロードしてアップロードすることなく、Gitリポジトリを探索
2. リポジトリ全体の内容にアクセスし、自動的にトークン化カウントを行う
3. リポジトリ構造とファイル内容を横断してナビゲート
4. 完全な内容を取得する前に、リポジトリのサイズを迅速に評価

使用シナリオ

• リポジトリのサイズと構造を迅速に確認し（特に大規模なリポジトリを扱う場合）、すべての内容を取得する価値があるかどうかを判断する場合は、estimate_codebaseを使用
• 実際のコードとファイル内容を分析する必要がある場合は、get_codebaseを使用

利用可能なツール

• get_codebase(repo_url: str, use_token: bool = True) -> str：Gitリポジトリをクローンして分析し、完全なファイル内容を返す
• estimate_codebase(repo_url: str, use_token: bool = True) -> str：提供されたリポジトリの統計情報（ファイル数、構造、トークン推定を含む）を迅速に分析する
• check_gitlab_token_status() -> str：GitLabトークンが設定されているかどうかを確認する

🔧 技術詳細

環境の設定

# リポジトリをクローン
git clone https://github.com/jmiedzinski/mcp-git-explorer.git
cd mcp-git-explorer

# 開発依存関係をインストール
uv pip install -e ".[dev]"

ローカルでの実行

# 直接実行
python -m mcp_git_explorer.cli

# MCP CLIを使用して実行
mcp dev mcp_git_explorer/cli.py

# uvxを使用して実行
uvx mcp-git-explorer

📄 ライセンス

MIT