Git Mcp 1fl

🚀 项目 git-mcp

这个项目是一个模型上下文协议 (MCP) 服务器，它能够与 Git 仓库进行交互，提供了管理 Git 仓库并通过 MCP 工具对其进行操作的功能。

🚀 快速开始

本项目是一个用于与 Git 仓库交互的模型上下文协议 (MCP) 服务器。下面将为你介绍如何快速开启项目的使用。

✨ 主要特性

• ✅ 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",
// 原文档此处未完整，推测后续可能还有内容
}
]