git-mcp

git-mcp

此项目是一个模型上下文协议（MCP）服务，旨在与 Git 仓库交互。它提供了通过 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": "Initial commit"
  }
]

---

🔹 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": "New line added",
      "lineNumber": 42
    }
  ]
}

---

🔹 git-file-history

查看特定文件的提交历史记录。

📌 参数：

• file_path（必填）：要查看历史记录的文件路径
• limit（可选）：要显示的提交数量（默认值：10）

📌 示例响应：

[
  {
    "hash": "1234567890abcdef",
    "author": "John Doe",
    "date": "2024-03-20",
    "message": "Update README.md"
  }
]