Git MCP 1fl

🚀 git-mcp

このプロジェクトは、Git リポジトリとのインタラクションを目的としたモデルコンテキストプロトコル (MCP) サーバーです。MCP ツールを通じて Git リポジトリを管理および操作する機能を提供します。

🚀 クイックスタート

このプロジェクトは、Git リポジトリとのインタラクションを目的としたモデルコンテキストプロトコル (MCP) サーバーです。MCP ツールを通じて Git リポジトリを管理および操作する機能を提供します。

✨ 主な機能

✅ Git リポジトリ管理：Git 操作を実行し、リポジトリを管理します。
✅ リポジトリ履歴：コミット履歴とファイルの経時的な変更を確認できます。
✅ ファイル追跡：ファイルの変更を追跡し、ファイルの履歴を確認できます。
✅ 差分操作：ファイル間の詳細な差分を確認できます。

📦 インストール

📋 前提条件

• Go 1.23.0 以上
• システムに Git がインストールされていること
• Git リポジトリへのアクセス権限があること

⚙️ セットアップ

1️⃣ パッケージのインストール

go install github.com/wricardo/git-mcp@latest

2️⃣ MCP クライアント設定の構成

以下の設定を MCP 設定に追加してください。

"git-mcp": {
  "command": "git-mcp",
  "env": {
    "WORKDIR": "/path/to/your/git/repository"
  },
  "disabled": false,
  "autoApprove": []
}

💻 使用例

基本的な使用法

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

git-mcp

高度な使用法

このサーバーにはいくつかの便利なツールが用意されています。

🔹 git-log

Git のコミット履歴を表示します。コミットハッシュ、作者、日付、メッセージが含まれます。

📌 パラメータ:

• limit (オプション): 表示するコミット数 (デフォルト: 10)

📌 応答例:

[
  {
    "hash": "1234567890abcdef",
    "author": "John Doe",
    "date": "2024-03-20",
    "message": "初始提交"
  }
]

🔹 git-changed-files

HEAD から指定した数のコミット分戻った時点でのファイルの変更リストを表示します。

📌 パラメータ:

• commits_back (必須): HEAD から戻るコミット数

📌 応答例:

[
  {
    "path": "README.md",
    "changeType": "modified"
  }
]

🔹 git-file-diff

特定のファイルの異なるコミット間の詳細な差分を表示します。

📌 パラメータ:

• file_path (必須): 差分を確認するファイルのパス
• commits_back (必須): HEAD から戻るコミット数

📌 応答例:

{
  "path": "README.md",
  "changes": [
    {
      "type": "add",
      "content": "新增行",
      "lineNumber": 42
    }
  ]
}

🔹 git-file-history

特定のファイルのコミット履歴を表示します。

📌 パラメータ:

• file_path (必須): 履歴を確認するファイルのパス
• limit (オプション): 表示するコミット数 (デフォルト: 10)

📌 応答例:

[
  {
    "hash": "1234567890abcdef",
    "author": "John Doe",
    "date": "2024-03-20",
    "message": "初始提交"
  }
]