git-mcp

本项目是一个 模型上下文协议 (MCP) 服务器，旨在与 Git 仓库进行交互。它提供了通过 MCP 工具管理和与 Git 仓库交互的功能。

---

🚀 功能

✅ Git 仓库管理: 执行 Git 操作并管理仓库。 ✅ 仓库历史: 查看提交历史和文件随时间的变化。 ✅ 文件追踪: 追踪文件更改并查看文件历史。 ✅ Diff 操作: 查看提交之间详细的文件差异。

---

📋 要求

• 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"
  }
]