Git MCP 1fl

🚀 項目 git-mcp

這個項目是一個模型上下文協議 (MCP) 服務器，主要用於與 Git 倉庫進行交互。它提供了管理 Git 倉庫的功能，並且可以通過 MCP 工具對其進行操作。

🚀 快速開始

本項目是一個模型上下文協議 (MCP) 服務器，可與 Git 倉庫交互，實現對倉庫的管理與操作。下面為你介紹使用前的準備、設置及使用方法。

✨ 主要特性

• ✅ 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",
    "date": "2024-03-20",
    "message": "初始提交"
  }
]