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。