mcp-git-enhanced

MCP Git Enhanced

MCP Git Enhanced は、AI コーディングアシスタントが日々のオープンソースのメンテナンスに必要なリポジトリの状態を調査できるようにする、Model Context Protocol サーバーです。

アシスタントに広範なシェルコマンドの実行を求めることなく、コードレビュー、コミット分析、ブランチ比較、リリース準備に利用できる、構造化された Git コンテキストをメンテナーに提供します。

メンテナーに利用される理由

オープンソースのメンテナーは、作業をレビューしたりマージしたりする前に、同じリポジトリに関する質問に何度も答えることに多くの時間を費やしています。

• このブランチでは何が変更されましたか？
• リリースノートに関係するコミットはどれですか？
• このブランチはベースブランチより遅れていますか？
• ステージング済み、未ステージング、未追跡のものは何ですか？
• クリーンアップが必要な、マージ済みまたは古いブランチはどれですか？

このサーバーは、これらのワークフローを用途に特化した MCP ツールとして提供し、アシスタントが PR レビュー、イシュートリアージ、リリース管理、リポジトリの整理を支援できるようにします。

利用可能なツール

ツール	目的
git_diff	作業ツリー、ステージング済みの変更、ブランチ、コミット、または指定したパスの差分を分析します。
git_log	作成者、期間、ブランチ、パス、統計情報で絞り込んでコミット履歴を確認します。
git_branch	ブランチの一覧表示、ブランチとそのベースの比較、クリーンアップ候補の提案を行います。
git_status	ステージング済み、未ステージング、未追跡のリポジトリの状態を要約します。
git_commit_analyze	1 つのコミットについて、メタデータ、変更ファイル、統計情報、差分出力を確認します。

インストール

ソースから

git clone https://github.com/davidweb3-ctrl/mcp-git-enhanced.git
cd mcp-git-enhanced
npm install
npm run build

Claude Code の設定

このリポジトリのビルド済みサーバーを使用します。

{
  "mcpServers": {
    "git-enhanced": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-git-enhanced/dist/index.js"]
    }
  }
}

npm からのインストール（今後）

パッケージは @davidweb3-ctrl/mcp-git-enhanced として公開されています。

npm install -g @davidweb3-ctrl/mcp-git-enhanced

公開後は、クライアントで次のように使用できます。

{
  "mcpServers": {
    "git-enhanced": {
      "command": "npx",
      "args": ["@davidweb3-ctrl/mcp-git-enhanced"]
    }
  }
}

ワークフローの例

PR レビュー

Use git_diff to compare this branch with master and summarize the risky files.
Use git_log to list commits since the last release.
Use git_commit_analyze on the largest commit before I review it.

イシュートリアージ

Use git_log to find recent commits touching src/tools.ts.
Use git_status to check whether the local reproduction has uncommitted changes.

リリース管理

Use git_branch compare against master to prepare release notes.
Use git_log with --stat style output to identify user-visible changes.
Use git_branch suggest_cleanup after the release branch is merged.

ツールの例

git_diff

{
  "repoPath": "/absolute/path/to/repo",
  "target": "HEAD~5",
  "source": "HEAD~10",
  "filePath": "src/",
  "staged": false
}

git_log

{
  "repoPath": "/absolute/path/to/repo",
  "maxCount": 20,
  "author": "Maintainer Name",
  "since": "1 week ago",
  "stat": true
}

git_branch

{
  "repoPath": "/absolute/path/to/repo",
  "action": "list",
  "includeRemote": true
}

{
  "repoPath": "/absolute/path/to/repo",
  "action": "compare",
  "branchName": "feature/pr-review-summary",
  "baseBranch": "master"
}

git_status

{
  "repoPath": "/absolute/path/to/repo",
  "short": false
}

git_commit_analyze

{
  "repoPath": "/absolute/path/to/repo",
  "commitHash": "abc123"
}

セキュリティモデル

MCP Git Enhanced は、リポジトリの調査を主な目的とするサーバーとして設計されています。

• シェルによる文字列展開を行わず、固定の git サブコマンドを spawnSync 経由で実行します。
• ブランチの削除、リセット、チェックアウト、リベース、プッシュ、強制プッシュといった破壊的な操作を行うツールは公開しません。
• ツールハンドラーを実行する前に、repoPath が Git リポジトリを指していることを検証します。
• ユーザーまたはメンテナーが管理するローカルリポジトリでの使用を想定しています。

報告方法とサポート対象バージョンについては、SECURITY.md を参照してください。

開発

npm install
npm run build
npm test
npm run lint
npm run format:check

プロジェクトファイル

• CONTRIBUTING.md：開発環境のセットアップとコントリビューションの手順。
• SECURITY.md：脆弱性の報告と信頼境界。
• ROADMAP.md：計画中のメンテナーワークフローとリリースの方針。
• CHANGELOG.md：リリースノート。
• docs/CODEX_FOR_OSS.md：オープンソース向け Codex メンテナンス計画。

要件

• Node.js >= 18.0.0
• Git がインストールされ、PATH から利用できること

ライセンス

MIT