local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides tools to read, search, and manipulate Git repositories via Large Language Models. Includes functionalities for viewing git status, diffs, committing changes, managing branches, and other git operations.

mcp-server-git：git MCP 服务器

概述

用于 Git 仓库交互和自动化的模型上下文协议服务器。该服务器提供通过大型语言模型读取、搜索和操作 Git 仓库的工具。

请注意，mcp-server-git 目前处于早期开发阶段。随着我们不断开发和改进服务器，其功能和可用工具可能会有所变更和扩展。

工具

git_status
- 显示工作树状态
- 输入：
  - repo_path （字符串）：Git 存储库的路径
- 返回：以文本输出的形式返回工作目录的当前状态
git_diff_unstaged
- 显示工作目录中尚未暂存的更改
- 输入：
  - repo_path （字符串）：Git 存储库的路径
- 返回：未暂存更改的差异输出
git_diff_staged
- 显示已提交的更改
- 输入：
  - repo_path （字符串）：Git 存储库的路径
- 返回：阶段性变化的差异输出
git_diff
- 显示分支或提交之间的差异
- 输入：
  - repo_path （字符串）：Git 存储库的路径
  - target （字符串）：要比较的目标分支或提交
- 返回：比较当前状态与目标的差异输出
git_commit
- 记录存储库的更改
- 输入：
  - repo_path （字符串）：Git 存储库的路径
  - message （字符串）：提交消息
- 返回：使用新的提交哈希确认
git_add
- 将文件内容添加到暂存区
- 输入：
  - repo_path （字符串）：Git 存储库的路径
  - files （string[]）：要暂存的文件路径数组
- 返回：暂存文件的确认
git_reset
- 取消暂存所有已暂存的更改
- 输入：
  - repo_path （字符串）：Git 存储库的路径
- 返回：重置操作确认
git_log
- 显示提交日志
- 输入：
  - repo_path （字符串）：Git 存储库的路径
  - max_count （数字，可选）：显示的最大提交数（默认值：10）
- 返回：包含哈希、作者、日期和消息的提交条目数组
git_create_branch
- 创建新分支
- 输入：
  - repo_path （字符串）：Git 存储库的路径
  - branch_name （字符串）：新分支的名称
  - start_point （字符串，可选）：新分支的起点
- 返回：确认分支创建
git_checkout

切换分支
输入：
- repo_path （字符串）：Git 存储库的路径
- branch_name （字符串）：要检出的分支的名称
返回：分支切换确认

git_show

显示提交的内容
输入：
- repo_path （字符串）：Git 存储库的路径
- revision （字符串）：要显示的修订（提交哈希、分支名称、标签）
返回：指定提交的内容

git_init

初始化 Git 存储库
输入：
- repo_path (字符串)：初始化 git repo 的目录路径
返回：存储库初始化的确认

安装

使用 uv（推荐）

使用uv时无需特殊安装。我们将使用uvx直接运行mcp-server-git 。

使用 PIP

或者，您可以通过 pip 安装mcp-server-git ：

pip install mcp-server-git

安装后，您可以使用以下命令将其作为脚本运行：

python -m mcp_server_git

配置

与 Claude Desktop 一起使用

将其添加到您的claude_desktop_config.json中：

"mcpServers": {
  "git": {
    "command": "uvx",
    "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
  }
}

注意：将“/Users/username”替换为你希望此工具可以访问的路径

"mcpServers": {
  "git": {
    "command": "docker",
    "args": ["run", "--rm", "-i", "--mount", "type=bind,src=/Users/username,dst=/Users/username", "mcp/git"]
  }
}

"mcpServers": {
  "git": {
    "command": "python",
    "args": ["-m", "mcp_server_git", "--repository", "path/to/git/repo"]
  }
}

与Zed一起使用

添加到您的 Zed settings.json：

"context_servers": [
  "mcp-server-git": {
    "command": {
      "path": "uvx",
      "args": ["mcp-server-git"]
    }
  }
],

"context_servers": {
  "mcp-server-git": {
    "command": {
      "path": "python",
      "args": ["-m", "mcp_server_git"]
    }
  }
},

调试

您可以使用 MCP 检查器来调试服务器。对于 uvx 安装：

npx @modelcontextprotocol/inspector uvx mcp-server-git

或者，如果您已将软件包安装在特定目录中或正在其上进行开发：

cd path/to/servers/src/git
npx @modelcontextprotocol/inspector uv run mcp-server-git

运行tail -n 20 -f ~/Library/Logs/Claude/mcp*.log将显示来自服务器的日志，并可能帮助您调试任何问题。

发展

如果您正在进行本地开发，则有两种方法可以测试您的更改：

运行 MCP 检查器来测试你的更改。请参阅“调试”了解运行说明。
使用 Claude 桌面应用进行测试。将以下内容添加到claude_desktop_config.json中：

Docker

{
  "mcpServers": {
    "git": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--mount", "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
        "--mount", "type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro",
        "--mount", "type=bind,src=/path/to/file.txt,dst=/projects/path/to/file.txt",
        "mcp/git"
      ]
    }
  }
}

紫外线

{
"mcpServers": {
  "git": {
    "command": "uv",
    "args": [ 
      "--directory",
      "/<path to mcp-servers>/mcp-servers/src/git",
      "run",
      "mcp-server-git"
    ]
  }
}

建造

Docker 构建：

cd src/git
docker build -t mcp/git .

执照

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Tools

View all tools