🚀 Git MCP 服务器

一个实现模型上下文协议 (MCP) 的服务器，为大型语言模型提供全面的 Git 功能，使其能够通过安全且标准化的接口执行版本控制操作。

🚀 快速开始

Git MCP Server 实现了由 Anthropic 创建的 Model Context Protocol (MCP)，该协议为大型语言模型和外部系统之间的通信提供了一个标准化接口。其架构包含客户端（如 Claude Desktop、IDE）、服务器以及 LLMs，能在 LLM 和外部系统之间创建安全边界，同时提供对 Git 功能的受控访问。

安装步骤

1. 克隆存储库

   git clone [repository-url]
   cd mcp-git-server
   

2. 安装依赖项

   npm install
   

3. 启动开发服务器（可选）

   npm run dev
   

配置环境变量

• PORT：指定服务运行的端口，默认为 3000。
• DEBUG：启用调试模式，值设为 true。

# 启动时设置环境变量
PORT=3001 DEBUG=true npm start

✨ 主要特性

核心 Git 操作

• 仓库初始化和克隆
• 文件阶段化和提交
• 分支管理
• 远端操作
• 标签处理
• 复制存档

批量操作

• 顺序操作执行
• 原子提交
• 智能默认值
• 错误恢复

安全功能

• 路径验证
• 仓库状态验证
• 嵌入式仓库处理
• 全面错误报告

📦 安装指南

设置步骤

1. 克隆存储库

   git clone [repository-url]
   cd mcp-git-server
   

2. 安装依赖项

   npm install
   

3. 启动开发服务器（可选）

   npm run dev
   

📚 详细文档

配置

环境变量

• PORT：指定服务运行的端口，默认为 3000。
• DEBUG：启用调试模式，值设为 true。

# 启动时设置环境变量
PORT=3001 DEBUG=true npm start

工具

安装依赖

npm install express mcp-router

最佳实践

• 路径管理：始终使用绝对路径，避免相对路径。
• 错误处理：在每次操作后检查结果，并记录日志或报告错误。

开发

# 构建项目
npm run build

# 监视文件变化
npm run watch

# 运行 MCP 检查工具
npm run inspector

错误处理

服务器提供详细的错误信息：

• 无效的路径或参数
• Git 命令失败
• 仓库状态错误
• 权限问题

贡献

欢迎贡献！请按照以下步骤操作：

1. ** Fork 代码库**
2. ** 创建功能分支**
3. ** 提交更改**
4. ** 推送到分支**
5. ** 创建 Pull Request**

对于 bug 和功能请求，请创建 issue。

接下来计划

暂未提及具体内容，但可期待后续更新。

📄 许可证

Apache License 2.0