← MCP

模型与开放条件Model & openness

本身不调用模型，是被客户端调用的接口实现。 直接调用本机 git 命令行，继承本机 git 版本与配置。

It calls no model itself; it is an interface implementation called by clients. It invokes the local git command line directly, inheriting the local git version and configuration.

运行位置Where it runs

本地进程，通过 stdio 通信； 也支持容器部署（Docker / Podman），但需显式挂载仓库目录。

2026-08-30 修复了容器 bind mount 在 Docker / Podman / SELinux 下的安全与兼容问题。

A local process communicating over stdio; container deployment (Docker / Podman) is also supported, but repository directories must be mounted explicitly.

A 2026-08-30 fix addressed security and compatibility issues of container bind mounts under Docker / Podman / SELinux.

本地文件Local files

通过 git 操作仓库，不需要任意文件读写。 每个工具都要求传入 repo_path，作用域限于该 git 仓库。 仓库内文件内容通过 git show / git_log 等命令间接读取。

Operates repositories through git; no arbitrary file read/write is needed. Every tool requires a repo_path, scoping it to that git repository. File contents inside the repository are read indirectly via git show / git_log and similar commands.

关机后的任务Tasks after shutdown

不支持。本地进程随客户端生死； 容器部署时取决于容器编排方式，不受本 server 自身控制。

Not supported. The local process lives and dies with the client; under container deployment it depends on the container orchestration, not controlled by this server itself.

工具与扩展Tools & extensions

提供 11 个工具，含：

• git_status
• git_diff_unstaged
• git_diff_staged
• git_diff
• git_commit
• git_add
• git_reset
• git_log
• git_create_branch
• git_checkout
• git_show

含 4 个写操作（commit / add / reset / checkout）， 输出为结构化文本或 diff，可直接消费。

It provides 11 tools, including:

• git_status
• git_diff_unstaged
• git_diff_staged
• git_diff
• git_commit
• git_add
• git_reset
• git_log
• git_create_branch
• git_checkout
• git_show

Including 4 write operations (commit / add / reset / checkout); output is structured text or diffs, ready for direct consumption.

上下文与记忆Context & memory

无跨会话记忆。状态完全由 git 仓库本身承载， 会话断开不影响仓库状态。

No cross-session memory. State is carried entirely by the git repository itself; session disconnects do not affect repository state.

权限与限制Permissions & limits

无独立审批机制。权限边界等于本机 git 用户的文件权限， 且具备完整写操作能力，包括提交、重置暂存区与切换分支。

git_reset 只取消暂存，不丢弃工作区改动； 但 git_checkout 可切换到任意分支。

No separate approval mechanism. The permission boundary equals the local git user's file permissions, and it has full write capability, including committing, resetting the staging area and switching branches.

git_reset only unstages and does not discard working-tree changes; but git_checkout can switch to any branch.

适合什么任务Best for

让 Agent 读取仓库状态、历史与 diff，并在受控前提下执行提交与分支操作。 不适合需要 push / PR / 远程仓库管理的场景。本 server 不提供远程操作。

Lets an Agent read repository status, history and diffs, and perform commits and branch operations under controlled conditions. Not a fit for scenarios needing push / PRs / remote repository management. This server provides no remote operations.

传输方式Transport

支持 stdio。README 同时给出容器部署方式（Docker / Podman）

与 uvx / pip 本地安装（2026-10-08 全文核验）； 没有远程传输（SSE / Streamable HTTP）的官方启动方式。

Supports stdio. The README also gives container deployment (Docker / Podman)

and uvx / pip local installation (full-text verification 2026-10-08); there is no official launch method for a remote transport (SSE / Streamable HTTP).

认证机制Authentication

无独立认证层。stdio 形态继承客户端用户的 git 权限； 容器形态的认证取决于容器编排配置，仓库未说明。

No separate authentication layer. In stdio form it inherits the client user's git permissions; for the container form, authentication depends on the container orchestration configuration and is not stated in the repo.

权限范围Permission scope

作用域限定在传入的 git 仓库，比 filesystem server 更收敛。

但具备完整写操作能力（commit / add / reset / checkout）， 无独立审批。切分支可改变工作区状态，需注意。

The scope is confined to the git repository passed in — narrower than the filesystem server.

But it has full write capability (commit / add / reset / checkout), with no separate approval. Switching branches can change working-tree state — take care.

本页由This page is generated from the ai-handbook 数据层生成（CC BY 4.0）。data layer (CC BY 4.0). 方法论与坐标系定义见仓库内For the methodology and coordinate definitions, see METHODOLOGY.md.