Git仓库管理协议服务器

一个通过MCP工具管理和交互Git仓库的协议服务器,提供仓库管理、历史查看、文件追踪和差异比较等功能。

  • by wricardo
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 wricardo/git-mcp

使用说明

git mcp

这个项目是 模型上下文协议(MCP)服务器 旨在与Git存储库交互。它提供了通过MCP工具管理Git存储库并与之交互的功能。


🚀 特性

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


📋 需求

  • 去 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日志

显示git提交历史记录,包括提交哈希、作者、日期和消息。

📌 参数:

  • limit (可选的):要显示的提交数(默认值:10)

📌 示例响应:

[
  {
    "hash": "1234567890abcdef",
    "author": "John Doe",
    "date": "2024-03-20",
    "message": "Initial commit"
  }
]

🔹 git更改了文件

在HEAD和指定数量的提交之间更改的列表文件。

📌 参数:

  • commits_back (必需的):从HEAD回顾的提交数量

📌 示例响应:

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

🔹 git文件差异

查看提交之间的详细文件差异。

📌 参数:

  • file_path (必需的):查看差异的文件路径
  • commits_back (必需的):从HEAD回顾的提交数量

📌 示例响应:

{
  "path": "README.md",
  "changes": [
    {
      "type": "add",
      "content": "New line added",
      "lineNumber": 42
    }
  ]
}

🔹 git文件历史记录

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

📌 参数:

  • file_path (必需的):查看历史记录的文件路径
  • limit (可选的):要显示的提交数(默认值:10)

📌 示例响应:

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