MCP Git Explorer

MCP Git Explorer

リモート Git リポジトリのコンテンツを構造化テキストファイルとして取得する、シンプルな MCP（Model Context Protocol）サーバーです。

機能

• Git リポジトリをクローンして分析
• リポジトリのコンテンツを構造化テキストとして生成
• すべてのコンテンツを取得せずに、コードベースの規模とトークン数をすばやく推定
• パブリックリポジトリと、トークン認証を使用するプライベート GitLab リポジトリに対応
• OpenAI の tiktoken ライブラリを使用したトークン数のカウント
• .gitignore と .repomixignore のパターンを尊重
• バイナリファイルと空のテキストファイルをスキップ
• Claude の Model Context Protocol との統合

インストール

PyPI から

pip install mcp-git-explorer

uv を使用

uv pip install mcp-git-explorer

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

uvx mcp-git-explorer

使用方法

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

# Basic usage
mcp-git-explorer

# Using SSE transport
mcp-git-explorer --transport sse

# Providing GitLab token
mcp-git-explorer --gitlab-token YOUR_TOKEN

環境変数

• GIT_EXPLORER_GITLAB_TOKEN：プライベートリポジトリにアクセスするための GitLab パーソナルアクセストークン

Claude での使用

MCP Git Explorer を使用すると、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 トークンが設定されているか確認します

開発

セットアップ

# Clone the repository
git clone https://github.com/jmiedzinski/mcp-git-explorer.git
cd mcp-git-explorer

# Install development dependencies
uv pip install -e ".[dev]"

ローカルでの実行

# Run directly
python -m mcp_git_explorer.cli

# Run via MCP CLI
mcp dev mcp_git_explorer/cli.py

# Run via uvx
uvx mcp-git-explorer

ライセンス

MIT