Git MCP Server

一個基於Model Context Protocol的Git服務器，為AI助手和LLM代理提供標準化的Git倉庫管理接口

版本控制開發者工具 #Git服務 #AI協作 #版本控制 #MCP協議 .TypeScript

評分 : 2.5分

下載量 : 55

更新時間 : 2025-04-29

什麼是GIT MCP服務器？

GIT MCP服務器是一個提供Git倉庫管理和操作的工具，它通過Model Context Protocol (MCP)協議實現標準化接口。用戶可以通過該服務器執行常見的Git操作，而無需直接訪問文件系統或命令行。

如何使用GIT MCP服務器？

用戶可以安裝服務器並將其集成到支持MCP的客戶端中，如Claude或其他AI助手。通過簡單的配置即可開始使用。

適用場景

適用於需要通過標準接口管理Git倉庫的開發人員、團隊以及自動化工具。

主要功能

倉庫管理初始化新倉庫、克隆遠程倉庫、檢查倉庫狀態。

分支操作創建、刪除、合併分支，切換分支。

工作目錄操作添加、提交、回滾更改，生成差異。

遠程倉庫操作添加、列出、拉取、推送遠程倉庫。

高級操作標記、存儲、回退、重置等高級Git命令。

優勢與侷限性

優勢

無需直接訪問文件系統或命令行即可操作Git。

支持多種Git操作，覆蓋常見需求。

易於與其他MCP兼容的工具集成。

提供標準化接口，便於擴展和維護。

侷限性

需要安裝Node.js和Git環境。

可能不支持某些複雜的自定義Git操作。

對網絡環境有一定依賴性。

如何使用

安裝服務器

通過NPM全局安裝或從源碼構建服務器。

啟動服務器

運行服務器以監聽MCP請求。

配置客戶端

在支持MCP的客戶端中添加服務器配置。

使用案例

克隆遠程倉庫通過GIT MCP服務器克隆遠程Git倉庫。

提交更改將本地更改提交到Git倉庫。

常見問題

如何安裝GIT MCP服務器？

服務器是否支持自定義Git命令？

服務器是否支持多用戶操作？

🚀 Git MCP 服務器

Git MCP 服務器是基於模型上下文協議（Model Context Protocol）的版本控制系統。它通過統一接口，提供 Git 倉庫的操作與數據查詢功能，支持分支管理、遠程倉庫配置等多種 Git 操作，還能以標準資源格式展示 Git 數據。

🚀 快速開始

Git MCP 服務器為用戶提供了便捷的方式來管理和查詢 Git 倉庫。通過簡單的安裝步驟，你就能快速啟動並使用它。

✨ 主要特性

基於模型上下文協議實現，提供統一接口進行 Git 倉庫操作和數據查詢。
支持多種常見的 Git 操作，如分支管理、遠程倉庫配置、提交歷史查看等。
通過標準資源格式 expose Git 數據，方便與其他系統集成。

📦 安裝指南

環境要求

操作系統：Linux、macOS 或 Windows（推薦使用 Linux）
Node.js：版本 14.0 或更高
npm：版本 6.0 或更高
Git：版本 2.35 或更高

安裝步驟

克隆倉庫：

git clone git://github.com/yourusername/git-mcp-server.git
cd git-mcp-server

安裝依賴：

npm install

啟動服務器：

node index.js

📚 詳細文檔

資源描述

Git MCP 服務器通過標準資源格式 expose Git 數據，以下是主要資源接口：

資源路徑	描述
`git://repo/{repoPath}/info`	提供 Git 倉庫的基本信息，包括當前分支、狀態和引用詳情
`git://repo/{repoPath}/branches`	列出倉庫中的所有分支及當前分支標識
`git://repo/{repoPath}/remotes`	顯示倉庫中配置的所有遠程倉庫及其 URL
`git://repo/{repoPath}/tags`	展示倉庫中的所有標籤及其引用信息
`git://repo/{repoPath}/file/{filePath}?ref={ref}`	返回指定文件在特定 Git 引用下的內容
`git://repo/{repoPath}/ls/{dirPath}?ref={ref}`	列出特定路徑和引用下目錄中的文件和子目錄
`git://repo/{repoPath}/diff/{fromRef}/{toRef}?path={path}`	提供兩個 Git 引用（如提交、分支、標籤）之間的差異報告
`git://repo/{repoPath}/diff-unstaged?path={path}`	展示工作目錄中所有未 staged 變更的 diff 信息
`git://repo/{repoPath}/diff-staged?path={path}`	返回索引中的所有 staged 變更的 diff 內容
`git://repo/{repoPath}/log?maxCount={maxCount}&file={file}`	獲取提交歷史記錄，支持指定最大返回數量和特定文件
`git://repo/{repoPath}/blame/{filePath}`	提供按行追溯信息，顯示每個代碼行最近修改的提交詳情
`git://repo/{repoPath}/commit/{commitHash}`	展示特定提交的詳細信息，包括變更 diff 等

開發指南

構建與測試

# 構建項目
npm run build

# 監控文件變化並自動重建
npm run watch

# 使用 MCP 檢查工具進行本地測試
npm run inspector

# 清理構建產物
npm run clean

# 生成文檔目錄樹視圖
npm run tree

# 完全清理後重新構建
npm run rebuild