Git MCP Server

一个基于Model Context Protocol的Git服务器，为AI助手和LLM代理提供标准化的Git仓库管理接口

版本控制开发者工具 #Git服务 #AI协作 #版本控制 #MCP协议 .TypeScript

评分 : 2.5分

下载量 : 8.1K

更新时间 : 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