💡 告别 AI 提交时的“金鱼脑”！MCP Git Server：具备持久化修改意图记录与强制审核闭环机制的深度 Git 协作方案，彻底解决长会话复杂场景下 AI 助手丢失修改上下文逻辑的痛点

你是否也曾陷入过这样的尴尬与沮丧：在一次深度编码会话中，你与 AI 助手配合默契，它行云流水般地帮你重构了核心模块、修复了深藏不露的 Bug，甚至还顺带优化了几个边缘组件。在这个过程中，变动横跨了 5、6 个甚至更多的文件，逻辑错综复杂，涉及了 3 个以上互相关联的功能点。然而，当大功告成，你满怀期待地指令它执行 git push 时，现实却给了你当头一棒——AI 生成的提交说明（Commit Message）竟然苍白无力地只写了“Update index.js”或者仅仅描述了它在最后五分钟里改动的那几行琐碎代码。

那一刻，你之前与它共同探讨的宏大设计、它在半小时前处理的关键边界情况，仿佛都在它的“电子脑”中烟消云散了。这种“金鱼般的短期记忆”不仅让项目的 Git 历史变得一团糟，更让你感到一种深深的无力感：你不得不停下手中的工作，翻遍文件差异，自己去人工拼凑那份本该由 AI 完整总结的提交说明。这种由于 AI 丢失上下文而导致的“协作断层”，正是目前大语言模型在处理复杂、长程 Git 任务时最令人头疼的顽疾。AI 往往只关注当下，而忽略了在漫长的对话链路中，它曾经付出过的那些努力。

MCP Git Server 正是为了终结这种糟糕的体验而生。它不仅仅是一个简单的 Git 命令转发器，它引入了创新的“修改记录存证”与“强制审查”工作流，通过物理级别的持久化存储，为 AI 换上了一颗“过目不忘”的记忆增强引擎，彻底解决 AI 协作中的上下文丢失痛点，让每一次推送都承载着完整的智慧结晶。

---

🚀 核心黑科技：持久化修改上下文

传统的 Git MCP 工具往往是“即改即忘”。我们的服务器通过一套闭环机制，确保 AI 的每一步心路历程都被记录：

1. 离线修改记录仪 (save_changes)

每当 AI 完成一个阶段性的代码修改，它必须调用 save_changes 将修改的文件列表和修改意图保存到服务器的持久化存储中（.setting/pending-changes.json）。即使会话重启，这些记录也不会丢失。

2. 强制审查过滤器 (get_pending_changes)

这是最关键的一步。在执行最终推送前，系统会校验状态。如果 AI 没有调用 get_pending_changes 读取并确认之前的修改记录，git_push 将被强行拦截。

目的： 强制 AI 在提交前“阅读”自己之前保存的所有记录，重新唤醒记忆。

3. 全局视角推送 (git_push)

在 AI 回顾完所有待处理的修改后，它才能生成一份涵盖所有变动的、完整且准确的 Commit Message。

---

💡 最佳实践与使用建议

为了充分发挥 MCP Git Server 的威力，建议在与 AI 协作时遵循以下“强约束”指令：

1. 原子化记录 (save_changes)：

   • 指令建议：“请在每次完成一个独立的小功能或修复一个 Bug 后，立即调用 save_changes 工具。你需要明确列出修改的文件，并用一两句话简述你的修改逻辑。严禁累积大量变动而不记录。”
   • 价值：这能确保 AI 的记忆碎片被实时固化，防止在后续复杂的重构中丢失初始意图。

2. 模块化推送 (git_push)：

   • 指令建议：“当我们完成当前功能模块的所有开发和自测后，请通过调用 git_push 进行推送。在推送前，你必须先通过 get_pending_changes 完整读取并总结我们本次会话的所有保存记录，生成一份结构清晰、涵盖所有变动的 Commit Message。”
   • 价值：将“总结历史记录”作为推送的法定前置步骤，彻底消灭“金鱼脑”提交。

3. 阶段性复盘：

   • 如果会话过程极长（如持续数小时），可以偶尔要求 AI 调用 get_pending_changes 进行一次中场总结，确保存储的记录与当前的实际代码状态完全吻合。

---

🛠️ MCP 工具列表与使用指南

以下是服务器提供的主要 MCP 工具，它们共同构建了完整的“AI 记忆增强”工作流：

记忆增强类（核心）

• save_changes:
  • 功能：由 AI 在修改代码后调用，保存修改的文件路径及修改意图描述。
  • 价值：将 AI 的临时记忆持久化，确保复杂任务中上下文不丢失。
• get_pending_changes:
  • 功能：列出所有已保存但未推送的修改记录，并激活推送权限。
  • 价值：强制 AI 推送前必须“回顾”全盘变动，生成更准确的提交说明。

Git 核心操作类

• git_push:
  • 功能：自动执行 add .、commit 并推送至指定的远程分支。
  • 前提：必须先调用 get_pending_changes 审查修改。
• git_status:
  • 功能：显示工作区和暂存区的状态。
  • 价值：让 AI 随时掌握当前代码变动概览。
• git_diff:
  • 功能：显示详细的文件差异（支持已暂存和未暂存）。
  • 价值：辅助 AI 分析修改逻辑，自查代码质量。
• git_log:
  • 功能：查看提交历史，支持 limit 和 oneline 模式。
• git_add:
  • 功能：将文件手动添加到暂存区。

辅助与管理类

• get_push_history:
  • 功能：获取最近 5 次推送记录。
  • 价值：防止 AI 重复提交或推送已存在的逻辑。
• get_operation_logs:
  • 功能：获取服务器运行日志。
  • 价值：开发者排查 AI 异常行为的“黑匣子”。

🔗 进阶联动：Gitee PR 自动化管理

如果你使用的是 Gitee 平台，还可以配合 mcp-server-gitee-pull-request 打造全自动的研发链路：

• 自动化 PR 创建：在 AI 推送完代码后，一键生成 Pull Request。
• 全自动流转：支持 AUTO_REVIEW（自动审查）、AUTO_TEST（自动测试）和 AUTO_MERGE（自动合并）。AI 不仅能写代码，还能帮你跑完从提交到合入的最后一步。
• 多实例隔离：与 Git Server 一样，支持通过 repo 隔离，完美适配多仓库环境。

安装： npm install -g @liangshanli/mcp-server-gitee-pull-request

💡 想要支持 GitHub/GitLab 或其他平台的 PR 工具？ 请在评论区留言或直接在 GitHub 上提交 Issue，我们会根据需求优先级进行开发！

---

⚙️ 环境变量配置指南

为了让 MCP Git Server 完美适配你的开发环境，我们提供了丰富的环境变量配置选项：

1. 核心必填项

变量名	说明	示例
PROJECT_PATH	Git 仓库的绝对路径	D:/projects/my-repo
LOCAL_BRANCH	需要推送的本地分支名	main
REMOTE_BRANCH	对应的远程分支名	main

2. 标识与隔离（多项目必备）

变量名	说明	默认值
REPO_NAME	仓库唯一标识，用于区分日志目录	(无)
TOOL_PREFIX	MCP 工具名前缀（如 my_git_push）	(无)
LANGUAGE	AI 交互与消息语言 (en/zh/zh-CN/zh-TW)	en

3. 网络与代理（企业环境必备）

支持标准代理协议，让 AI 即使在内网也能顺畅推送：

• HTTP_PROXY / HTTPS_PROXY: HTTP/HTTPS 代理
• SOCKS_PROXY: SOCKS5 代理
• ALL_PROXY: 全局代理
• NO_PROXY: 排除代理的域名列表（逗号分隔）

4. 日志与存储路径（高级自定义）

变量名	说明	默认值
MCP_LOG_DIR	日志存储目录	./.setting
MCP_LOG_FILE	运行日志文件名	mcp-git.log
MCP_CHANGES_FILE	关键： 待处理修改记录文件	pending-changes.json
MCP_PUSH_HISTORY_FILE	推送历史记录文件	push-history.json

---

🧰 Git 核心能力全家桶

除了独特的修改追踪机制，它还是一套完整的 Git 增强工具集，让 AI 能够深度介入你的开发工作流：

• git_status: 实时查看工作区状态，不错过任何一个未暂存的改动。
• git_diff: 逐行对比变更。AI 可以通过它分析代码逻辑的变化，确保提交质量。
• git_add: 灵活的暂存控制。支持按文件或全量添加。
• git_log: 回溯项目历史。AI 可以读取之前的提交记录，学习你的代码提交规范。
• get_push_history: 智能查重。在推送前检查是否已有相似提交，避免无效操作。

---

🛠️ 多项目集成示例 (Cursor/VS Code)

通过 TOOL_PREFIX 和 REPO_NAME，你可以在同一个编辑器界面中无缝切换并管理多个项目：

{
  "mcpServers": {
    "frontend-project": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-git"],
      "env": {
        "PROJECT_PATH": "D:/work/frontend",
        "REPO_NAME": "frontend",
        "TOOL_PREFIX": "web",
        "LOCAL_BRANCH": "main",
        "REMOTE_BRANCH": "main"
      }
    },
    "backend-api": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-git"],
      "env": {
        "PROJECT_PATH": "D:/work/backend",
        "REPO_NAME": "backend",
        "TOOL_PREFIX": "api",
        "LOCAL_BRANCH": "develop",
        "REMOTE_BRANCH": "develop"
      }
    }
  }
}

配置后，你的 AI 将拥有两套独立的技能组：

• web_git_push / web_save_changes … (针对前端项目)
• api_git_push / api_save_changes … (针对后端项目)
• 它们拥有各自独立的日志空间（.setting.frontend/ 和 .setting.backend/），记忆互不干扰！

---

📈 为什么你需要它？

• 防止提交说明缺失：不再只有 “Update code” 这种毫无意义的提交。
• 长会话保障：在处理复杂重构时，AI 能够通过读取记录，保持从第一行代码到最后一行代码的逻辑一致性。
• 审计透明：所有的操作和修改意图都会记录在 mcp-git.log 中，方便复盘 AI 的行为。

---

立即安装：
npm install -g @liangshanli/mcp-server-git

GitHub 仓库：
https://github.com/liliangshan/mcp-server-git

让你的 AI 助手拥有“过目不忘”的 Git 提交能力！