GIT MCP Server

GIT MCP サーバー

Git リポジトリを操作するためのツールを提供する Model Context Protocol（MCP）サーバーです。このサーバーを使うと、AI アシスタントや LLM エージェントは、ファイルシステムやコマンドラインへの直接アクセスを必要とせず、標準化されたインターフェースを通じてリポジトリ、ブランチ、コミット、ファイルを管理できます。適切なセキュリティ境界を維持しながら、Git 操作を MCP リソースおよびツールとして公開します。

目次

• 概要
  • アーキテクチャとコンポーネント
• 機能
  • リソースへのアクセス
  • Git 操作
• インストール
  • 前提条件
  • NPM からインストール
  • ソースからインストール
• 使用方法
  • サーバーの実行
  • Claude との連携
  • その他の MCP クライアントとの連携
• プロジェクト構成
• ツール
  • リポジトリ操作
  • ブランチ操作
  • 作業ディレクトリの操作
  • リモート操作
  • 高度な操作
• リソース
  • リポジトリリソース
• 開発
  • ビルドとテスト
• ライセンス

概要

主な機能：

• リポジトリ管理：リポジトリの初期化、クローン、状態の確認
• ブランチ操作：ブランチの作成、一覧表示、チェックアウト、削除、マージ
• 作業ディレクトリ：ファイルのステージング、変更のコミット、差分の作成
• リモート操作：リモートの追加、フェッチ、プル、プッシュ
• 高度な Git コマンド：タグの管理、変更のスタッシュ、チェリーピック、リベース

アーキテクチャとコンポーネント

システムのコアアーキテクチャ：

flowchart TB
    subgraph API["API Layer"]
        direction LR
        MCP["MCP Protocol"]
        Val["Validation"]

        MCP --> Val
    end

    subgraph Core["Core Services"]
        direction LR
        GitService["Git Service"]
        ErrorService["Error Service"]

        GitService <--> ErrorService
    end

    subgraph Resources["Resource Layer"]
        direction LR
        Repo["Repository Resources"]
        Diff["Diff Resources"]
        File["File Resources"]
        History["History Resources"]

        Repo <--> Diff
        Repo <--> File
        Repo <--> History
    end

    subgraph Tools["Tool Layer"]
        direction LR
        RepoTools["Repository Tools"]
        BranchTools["Branch Tools"]
        WorkdirTools["Working Directory Tools"]
        RemoteTools["Remote Tools"]
        AdvancedTools["Advanced Tools"]

        RepoTools <--> BranchTools
        BranchTools <--> WorkdirTools
        WorkdirTools <--> RemoteTools
        RemoteTools <--> AdvancedTools
    end

    Val --> GitService
    GitService --> Resources
    GitService --> Tools

    classDef layer fill:#2d3748,stroke:#4299e1,stroke-width:3px,rx:5,color:#fff
    classDef component fill:#1a202c,stroke:#a0aec0,stroke-width:2px,rx:3,color:#fff
    classDef api fill:#3182ce,stroke:#90cdf4,stroke-width:2px,rx:3,color:#fff
    classDef core fill:#319795,stroke:#81e6d9,stroke-width:2px,rx:3,color:#fff
    classDef resource fill:#2f855a,stroke:#9ae6b4,stroke-width:2px,rx:3,color:#fff
    classDef tool fill:#805ad5,stroke:#d6bcfa,stroke-width:2px,rx:3,color:#fff

    class API,Core,Resources,Tools layer
    class MCP,Val api
    class GitService,ErrorService core
    class Repo,Diff,File,History resource
    class RepoTools,BranchTools,WorkdirTools,RemoteTools,AdvancedTools tool

コアコンポーネント：

• MCP サーバー：Model Context Protocol SDK を使用して、リソースとツールを公開するサーバーを作成します
• Git サービス：simple-git の抽象化レイヤーとして、Git 操作用の使いやすいインターフェースを提供します
• リソース：一貫した URI テンプレートを使用して、Git データを MCP リソースとして公開します
• ツール：明確に定義されたスキーマを使用して、Git 操作を MCP ツールとして公開します
• エラー処理：標準化されたエラー処理と報告

機能

リソースへのアクセス

MCP リソースを通じて Git リポジトリ情報を公開します。

• リポジトリ情報：現在のブランチ、ステータス、参照の詳細など、Git リポジトリの基本情報にアクセスします
• リポジトリのブランチ：現在のブランチを示す印を付けて、リポジトリ内のすべてのブランチを一覧表示します
• リポジトリのリモート：設定済みのすべてのリモートリポジトリとその URL を一覧表示します
• リポジトリのタグ：リポジトリ内のすべてのタグとその参照を一覧表示します
• ファイルの内容：指定した Git 参照における特定のファイルの内容にアクセスします
• ディレクトリ一覧：特定のパスと参照にあるファイルおよびディレクトリの一覧を表示します
• 差分：参照間、ステージングされていない変更、またはステージング済みの変更の差分を取得します
• コミット履歴：作成者、日付、メッセージ情報を含む詳細なコミットログを表示します
• ファイルの Blame：各行を最後に変更したコミットを示す、行ごとの帰属情報を確認します
• コミットの詳細：差分の変更内容など、特定のコミットの詳細情報にアクセスします

Git 操作

MCP ツールを通じて Git コマンドを実行します。

• リポジトリ操作：リポジトリの初期化、リモートからのクローン、リポジトリのステータス確認
• ブランチ操作：ブランチの作成、一覧表示、チェックアウト、削除、マージ
• 作業ディレクトリ操作：ファイルのステージング、ステージング解除、変更のコミット、差分の作成
• リモート操作：リモートの追加、一覧表示、フェッチ、プル、プッシュ
• 高度な操作：タグの管理、変更のスタッシュ、コミットのチェリーピック、ブランチのリベース、リセット、クリーン

インストール

前提条件

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

NPM からインストール

npm install -g git-mcp-server

ソースからインストール

git clone https://github.com/cyanheads/git-mcp-server.git
cd git-mcp-server
npm install
npm run build

使用方法

サーバーの実行

git-mcp-server

サーバーは Model Context Protocol を使用して stdin/stdout 経由で通信するため、あらゆる MCP クライアントと互換性があります。

Claude との統合

Claude の設定ファイルに追加します。

{
  "mcpServers": {
    "git": {
      "command": "git-mcp-server",
      "args": [],
      "env": {},
      "disabled": false
    }
  }
}

その他の MCP クライアントとの統合

MCP インスペクターを使用してサーバーをテストします。

npx @modelcontextprotocol/inspector git-mcp-server

プロジェクト構成

コードベースはモジュール構成になっています。

git-mcp-server/
├── src/
│   ├── index.ts           # Entry point
│   ├── server.ts          # MCP server implementation
│   ├── resources/         # Resource implementations
│   │   ├── descriptors.ts # Resource URI templates
│   │   ├── diff.ts        # Diff-related resources
│   │   ├── file.ts        # File-related resources
│   │   ├── history.ts     # History-related resources
│   │   ├── index.ts       # Resource registration
│   │   └── repository.ts  # Repository resources
│   ├── services/          # Service implementations
│   │   ├── error-service.ts # Error handling
│   │   └── git-service.ts   # Git operations abstraction
│   ├── tools/             # Tool implementations
│   │   ├── advanced.ts    # Advanced Git operations
│   │   ├── branch.ts      # Branch operations
│   │   ├── index.ts       # Tool registration
│   │   ├── remote.ts      # Remote operations
│   │   ├── repository.ts  # Repository operations
│   │   └── workdir.ts     # Working directory operations
│   ├── types/             # Type definitions
│   │   └── git.ts         # Git-related types
│   └── utils/             # Utility functions
│       └── validation.ts  # Input validation
└── scripts/               # Development scripts

ツール

Git MCP Server は、Git 操作用の包括的なツール群を提供します。

リポジトリ操作

ブランチ操作

作業ディレクトリの操作

リモート操作

高度な操作

リソース

Git MCP Server は、標準の MCP リソースを通じて Git データを公開します。

リポジトリリソース

開発

ビルドとテスト

# Build the project
npm run build

# Watch for changes
npm run watch

# Test with MCP inspector
npm run inspector

# Clean build artifacts
npm run clean

# Rebuild completely
npm run rebuild

ライセンス

Apache License 2.0 — 詳細は LICENSE を参照してください。