Git Commit Aider

🚀 Git 提交助手 MCP 服务器

Git 提交助手 MCP 服务器可让 AI 代您进行 Git 提交，方便在代码库中追踪 AI 的贡献。这是一个基于 TypeScript 的 MCP 服务器，能提供工具来代替您对 Git 存档中的更改进行提交，同时在提交者姓名后添加“(aider)”。

🚀 快速开始

将此服务器配置添加到您的 MCP 设置文件中，即可使用它让 AI 代您完成 Git 提交。

✨ 主要特性

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

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

将此工具安装在您的代码编辑器中后，您可以向 AI 发出提示，如“为我提交这些更改”。通常，在 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 命令的输出。

💻 使用示例

基础用法

在代码编辑器安装此工具后，向 AI 提示“为我提交这些更改”，AI 即可完成提交操作。

高级用法

当需要指定工作目录时，可以在调用 commit_staged 工具时传入 cwd 参数，示例如下：

{
"mcpServers": {
"git-commit-aider": {
"command": "npx",
"args": ["mcp-git-commit-aider"]
}
},
"commit_staged": {
"message": "这是一个提交消息",
"cwd": "/path/to/your/git/repo"
}
}

🔧 技术细节

开发

• 安装依赖项：

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。