
Git MCP Server

2025.01.03
0
TypeScript版本控制Git 自动化开发效率
Git MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,为大型语言模型 (LLMs) 提供全面的 Git 功能。它通过安全且标准化的接口,使 LLMs 能够执行版本控制操作,包括仓库初始化、克隆、文件暂存、提交、分支管理等。该服务器适用于需要自动化 Git 操作的场景,如代码管理、版本控制和协作开发。
View on GitHub
Overview
基本能力
产品定位
Git MCP Server 是一个为大型语言模型 (LLMs) 提供 Git 功能的服务,通过 Model Context Protocol (MCP) 实现标准化通信,使 LLMs 能够安全地执行版本控制操作。
核心功能
- 核心 Git 操作:
- 仓库初始化和克隆
- 文件暂存和提交
- 分支管理
- 远程操作
- 标签处理
-
暂存管理
-
批量操作:
- 顺序执行操作
- 原子提交
- 智能默认值
-
错误恢复
-
安全特性:
- 路径验证
- 仓库状态验证
- 嵌入式仓库处理
- 全面的错误报告
适用场景
- 自动化代码版本控制
- 协作开发中的 Git 操作自动化
- 大型语言模型与 Git 仓库的交互
工具列表
- 基本操作:
init
:初始化 Git 仓库clone
:克隆仓库-
status
:获取仓库状态 -
批量操作:
-
bulk_action
:执行多个 Git 操作序列 -
分支操作:
-
branch_list
、branch_create
、branch_delete
、checkout
:管理分支和工作树 -
标签操作:
-
tag_list
、tag_create
、tag_delete
:管理仓库标签 -
远程操作:
-
remote_list
、remote_add
、remote_remove
:管理远程仓库 -
暂存操作:
stash_list
、stash_save
、stash_pop
:管理工作目录更改
常见问题解答
- 路径管理:必须使用绝对路径,并在操作前验证路径。
- 批量操作:推荐使用
bulk_action
执行多个操作,并正确处理操作依赖关系。 - 错误处理:检查操作结果,处理部分成功场景,并验证仓库状态。
使用教程
使用依赖
- 确保已安装 Node.js 和 Git。
安装教程
- 克隆仓库:
bash git clone https://github.com/cyanheads/git-mcp-server.git
- 进入项目目录:
bash cd git-mcp-server
- 安装依赖:
bash npm install
- 构建项目:
bash npm run build
调试方式
- 构建项目:
bash npm run build
- 监听更改:
bash npm run watch
- 运行 MCP 检查器:
bash npm run inspector