Git Commit Aider

🚀 Git 提交助手 MCP 服务器

Git 提交助手 MCP 服务器可让 AI 代您进行 Git 提交，方便在代码库中追踪 AI 的贡献。它基于 TypeScript 构建，能自动在提交者姓名后添加“(aider)”，让您清晰区分 AI 提交。

🚀 快速开始

Git 提交助手 MCP 服务器是一个强大的工具，借助它，AI 可以代替您完成 Git 提交操作，同时在代码库中清晰展示 AI 的贡献。使用时，您只需将其配置添加到 MCP 设置文件中，即可让 AI 为您完成提交任务。

✨ 主要特性

此 MCP 服务器仅提供一个工具：

• commit_staged - 提交已存档的更改并指定消息。
  • 接受 message（字符串，必需）作为提交消息。
  • 接受 cwd（字符串，可选）以指定 Git 命令的工作目录。
  • 自动在提交者姓名后添加“(aider)”。
  • 从环境变量 (GIT_COMMITTER_NAME, GIT_COMMITTER_EMAIL) 中读取提交者姓名和电子邮件。若未设置，则回退到 git config user.name 和 git config user.email 的输出。

将此工具安装在代码编辑器后，您可以向 AI 发出提示，例如：“为我提交这些更改”。通常，在 AI 对代码库进行更改后，它能提供合适的提交消息。带有“(aider)”的提交可被 aider --stats 命令检测到，该命令会显示代码库中 AI 的贡献。

📦 安装指南

要使用此服务器，请将其配置添加到您的 MCP 设置文件中：

{
  "mcpServers": {
    "git-commit-aider": {
      "command": "npx",
      "args": ["mcp-git-commit-aider"]
    }
  }
}

提交者信息从以下位置获取：

1. 环境变量 GIT_COMMITTER_NAME 和 GIT_COMMITTER_EMAIL，遵循 Git 的约定。
2. git config user.name 和 git config user.email 命令的输出。

💻 使用示例

基础用法

将配置添加到 MCP 设置文件后，您可以向 AI 发出提交更改的提示，如“为我提交这些更改”，AI 会根据情况生成合适的提交消息并完成提交。

高级用法

在不同的工作目录下使用 commit_staged 工具时，可通过 cwd 参数指定工作目录，示例如下：

{
  "mcpServers": {
    "git-commit-aider": {
      "command": "npx",
      "args": ["mcp-git-commit-aider"],
      "options": {
        "cwd": "/path/to/your/git/repo"
      }
    }
  }
}

🔧 技术细节

此服务器基于 TypeScript 开发，通过标准输入输出与 MCP 进行通信。它会从环境变量或 Git 配置中获取提交者信息，并在提交时自动添加“(aider)”标识。在开发过程中，使用 npm 进行依赖管理和构建操作。

📚 详细文档

开发

• 安装依赖项：

npm install

• 构建服务器：

npm run build

• 带自动重建功能的开发：

npm run watch

示例 MCP 配置

{
  "mcpServers": {
    "git-commit-aider": {
      "command": "node",
      "args": [
        "/path/to/git-commit-aider/build/index.js"
      ]
    }
  }
}

(请将 /path/to/git-commit-aider 替换为实际路径。)

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能具有挑战性。我们推荐使用 MCP Inspector，它作为一个包脚本可用：

npm run inspector

Inspector 将提供一个访问浏览器中的调试工具的 URL。