AI导哈

Git操作协议服务器

Git MCP Server是一个为Git操作提供模型上下文协议(MCP)的服务，支持全面的Git功能，适用于开发者在多项目环境中进行版本控制和管理。

  • by DanyelKirsch
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 DanyelKirsch/git-mcp-server

使用说明

Git MCP服务器

用于Git操作的模型上下文协议（MCP）服务器，为Claude Desktop等MCP客户端提供全面的Git功能。

特性

  • 上下文感知：根据工作目录自动检测当前项目
  • 全面的Git操作：状态、分支、差异、日志、文件内容、提交等
  • 多项目支持：跨不同项目目录无缝工作
  • 错误处理：正确的MCP错误响应
  • 分行管理：创建、切换和管理分支
  • 远程操作：从远程存储库推送、拉取和获取

安装

选项1：全局安装（推荐）

npm install -g git-mcp-server

选项2：地方发展设置

  1. 克隆并安装：

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

  2. 构建项目：

    npm run build

配置

克劳德桌面

将此服务器添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "git": {
      "command": "git-mcp-server",
      "args": []
    }
  }
}

其他MCP客户端

对于其他MCP客户端，直接使用服务器二进制文件：

git-mcp-server

服务器将自动使用当前工作目录作为Git存储库上下文。

用法

配置后，您可以通过MCP客户端使用Git操作。服务器会自动检测您当前工作目录中的Git存储库。

示例命令

让你的MCP客户端（如Claude）执行Git操作：

  • “当前的git状态是什么？”
  • “显示与主分支的差异”
  • “创建一个名为feature/new feature的新分支”
  • “通过消息“修复解析器中的错误”提交这些更改”
  • “将当前分支推送到原点”

测试服务器

您可以从任何Git存储库手动测试服务器：

cd /path/to/your/git/repo
git-mcp-server

可用工具

存储库信息

  • git_status -获取当前git状态
  • git_current_branch -获取当前分支名称
  • git_staged_changes -获取分阶段更改
  • git_working_directory -获取当前工作目录信息

文件和历史操作

  • git_diff -显示分支/提交之间的差异
  • git_log -获取提交历史记录
  • git_show_file -在特定提交时显示文件内容

转移操作

  • git_branches -列出所有分支
  • git_checkout -切换到其他分支或创建新分支

暂存和提交操作

  • git_add -将文件添加到暂存区
  • git_commit -使用消息和文件创建提交

远程操作

  • git_pull -从远程存储库中提取更改
  • git_fetch -从远程获取更改而不进行合并

库管理

  • git_init -初始化一个新的git仓库

先决条件

  • Node.js 18+
  • npm或纱线
  • Git已安装在您的系统上

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 如果适用，添加测试
  5. 提交拉取请求

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

项目结构

git-mcp-server/
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── src/
│   └── index.ts         # Main server implementation
├── build/
│   └── index.js         # Compiled JavaScript (generated)
└── README.md            # This file

发展

  • npm run build -构建TypeScript代码
  • npm run dev -开发观看模式
  • npm start -运行内置服务器

相关 MCP