Git Proxy MCP

git代理mcp

您的Git凭据将保留在您的计算机上。你的仓库位于人工智能的工作空间中。

一个安全的MCP服务器，允许基于云的AI助手（Claude.AI、ChatGPT、Gemini等） 使用现有的Git凭据使用私有Git存储库，而无需这些凭据 证书永远不会离开你的机器。

______________________________________________________________________

问题

基于云的AI编码助手面临着一个根本的困境：

结果： AI助手可以编写代码，但实际上不能像真正的开发人员那样在你的项目上工作。

解决方案

git代理mcp充当 经过身份验证的流媒体代理 Git提供者和AI工作区之间：

┌─────────────────┐      ┌─────────────────┐      ┌─────────────────┐
│  Git Providers  │      │    YOUR PC      │      │    AI's VM      │
│                 │      │                 │      │                 │
│  GitHub         │◄────►│  git-proxy-mcp  │◄────►│  Claude.ai      │
│  GitLab         │      │                 │      │                 │
│  Bitbucket      │      │  (credentials   │      │  /home/claude/  │
│  Azure DevOps   │      │   stay here)    │      │    repo/        │
│  Self-hosted    │      │                 │      │  (files live    │
│                 │      │                 │      │   here)         │
└─────────────────┘      └─────────────────┘      └─────────────────┘

关键见解： AI有自己的VM，具有完整的Linux功能。它只是无法对您的私人存储库进行身份验证。我们解决 *仅* 这个问题。

运作原理

1. 克隆： AI请求回购→ MCP服务器进行身份验证→ 将文件直接流式传输到AI的VM
2. 工作： AI有一个完整的本地git仓库。分支、编辑、测试、提交——都是原生的。
3. 推： AI发送提交→ MCP服务器进行身份验证→ 推到远程

凭证永远不会离开你的机器。文件永远不会碰你的机器。

______________________________________________________________________

这是给谁的？

______________________________________________________________________

比较：GitHub MCP与git代理MCP

______________________________________________________________________

建筑

安全模型

┌─────────────────────────────────────────────────────────────────┐
│  YOUR PC (credentials stay here, files don't)                   │
│                                                                 │
│  ┌──────────────────┐      ┌─────────────────────────────────┐  │
│  │ git-proxy-mcp    │      │ Your Git Configuration          │  │
│  │                  │◄────►│                                 │  │
│  │ • Auth callbacks │      │ • ~/.gitconfig                  │
│  │ • Object stream  │      │ • SSH keys (ssh-agent)          │  │
│  │ • No file storage│      │ • Credential helpers            │  │
│  └────────┬─────────┘      └─────────────────────────────────┘  │
│           │                                                     │
└───────────┼─────────────────────────────────────────────────────┘
            │
            │ Streaming: files/patches (NOT credentials)
            ▼
┌─────────────────────────────────────────────────────────────────┐
│  AI's VM (files live here, credentials don't)                   │
│                                                                 │
│  ┌──────────────────┐                                           │
│  │ /home/claude/    │  AI workflow (all local, no network):     │
│  │   repo/          │  • git checkout -b feature                │
│  │     .git/        │  • vim src/main.rs                        │
│  │     src/         │  • cargo test                             │
│  │     Cargo.toml   │  • git commit -m "fix bug"                │
│  └──────────────────┘                                           │
└─────────────────────────────────────────────────────────────────┘

什么流向哪里

______________________________________________________________________

MCP工具

第1层：单一响应工具

repo_clone

将存储库流式传输到AI的工作区（中小型存储库）。

{
    "name": "repo_clone",
    "arguments": {
        "url": "https://github.com/user/private-repo",
        "branch": "main",
        "depth": 1,
        "sparse": ["src/", "Cargo.toml"]
    }
}

上面未显示的可选参数：

• exclude_binary （bool）--跳过二进制文件
• max_file_size （数量，字节）--跳过超过大小限制的文件
• resolve_lfs （bool）-获取LFS指针文件并用其实际内容替换
• include_submodules （bool）--递归获取子模块
• submodule_depth （number）——子模块递归深度。省略为无限（镜像

git clone --recurse-submodules). 1 =仅顶层子模块； 0 =跳过子模块 完全（覆盖 include_submodules: true).

• submodule_include （glob模式数组）--仅获取与至少一个模式匹配的子模块
• submodule_exclude （glob模式数组）--跳过匹配任何模式的子模块（优先于include）

答复： Base64编码tar.gz archive, commit 沙， branch, file_count, archive_size （字节，base64之前），以及a hint 字符串指向 helper_script 用于提取。 可选计数器仅在非零时显示： skipped_by_filter, skipped_binary, skipped_too_large, lfs_resolved, lfs_failed, submodules_included, submodules_failed.

repo_push

将git包从AI的工作区推送到远程。

{
    "name": "repo_push",
    "arguments": {
        "url": "https://github.com/user/private-repo",
        "branch": "feature/fix-bug",
        "bundle": "",
        "force": false
    }
}

答复： branch，推 commit 沙， force 消毒过的旗帜（回声） remote_url, 和一个 hint 解释如何为后续推送创建包的字符串。

第2层：分块流媒体工具（大型仓库）

对于太大而无法在单个响应中传输的存储库。

repo_clone_start

启动分块克隆会话。

{
    "name": "repo_clone_start",
    "arguments": {
        "url": "https://gitlab.com/org/large-repo",
        "branch": "main",
        "depth": 1,
        "chunk_size": 1048576
    }
}

上面未显示的可选参数 --与对应的语义相同 repo_clone 上面记录的论点：

• sparse （路径/球体阵列）
• exclude_binary （布尔）
• max_file_size （数字，字节）
• resolve_lfs （布尔）
• include_submodules （布尔）
• submodule_depth （编号）
• submodule_include （球状图案阵列）
• submodule_exclude （球状图案阵列）

答复： session_id, total_chunks, total_size （字节，base64之前的总存档大小）， chunk_size （字节，夹紧后协商的每个块大小）， commit, branch, file_count, 和一个 hint 弦。与跳过/LFS/子模块计数器相同的可选计数器 repo_clone 当非零时出现。

repo_clone_chunk

从流媒体会话中获取数据块。

{
    "name": "repo_clone_chunk",
    "arguments": {
        "session_id": "stream_abc123",
        "chunk_index": 0
    }
}

答复： Base64编码 data，the chunk_index （回应）， chunk_size （这一块 base64之前的字节大小）， is_last 旗，以及 next_missing_chunk （当没有块时省略 resident——用于在传输中断后恢复）。

repo_clone_status

检查分块克隆会话的进度和恢复状态。

{
    "name": "repo_clone_status",
    "arguments": {
        "session_id": "stream_abc123"
    }
}

答复： session_id （回应）， total_chunks, delivered_chunks, next_missing_chunk （当检索到所有块时为空）， progress_percent （0.0–100.0），以及 is_complete 旗帜。

repo_clone_cancel

取消流媒体会话（可选，在配置的超时后自动过期）。

{
    "name": "repo_clone_cancel",
    "arguments": {
        "session_id": "stream_abc123"
    }
}

答复： { "cancelled": } — true 如果找到并删除了会话， false 如果不存在这样的会话（不是错误）。

其他工具

repo_pull

将远程的新更改同步到AI的工作区。

{
    "name": "repo_pull",
    "arguments": {
        "url": "https://github.com/user/private-repo",
        "branch": "main",
        "since_commit": "abc123"
    }
}

答复： 统一 diff，base64 tar.gz更改/添加的文件(files_archive), changed_files 列出每个文件的更改类型， deleted_files 列表， base_commit 和 new_commit SHA，更改 stats, up_to_date 旗，和a hint 字符串指向 helper_script 用于提取 files_archive.

repo_diff

获取两次提交之间的差异。

{
    "name": "repo_diff",
    "arguments": {
        "url": "https://github.com/user/private-repo",
        "base_commit": "abc123",
        "head_commit": "def456"
    }
}

答复： 统一 diff 文本， stats （添加/删除/文件更改计数），以及 完全解决 base_commit 和 head_commit SHA（这样AI就可以缓存比较结果，而无需 重新解析原始参考文献）。

repo_refs

列出远程分支和标签。

{
    "name": "repo_refs",
    "arguments": {
        "url": "https://github.com/user/private-repo"
    }
}

答复： branches 和 tags 列表（每个条目都有引用名称和提交SHA）， default_branch （例如。 main 或 master，从远程HEAD获取），以及 total_refs 计数。

公用事业

helper_script

获取一个Python辅助脚本来处理结果（解码base64，提取tar.gz）。

{
    "name": "helper_script",
    "arguments": {}
}

答复： Python脚本源代码，加上建议 filename，简短 usage 指令和脚本 version.

______________________________________________________________________

安装

先决条件

Git命令行界面

服务器调用 git 对于两个操作： git credential fill （读取您存储的 通过操作系统凭据助手获取凭据——请参阅 src/git2_ops/auth.rs)以及 git bundle unbundle （申请a repo_push 经过身份验证的推送之前的有效载荷——请参阅 src/git2_ops/push.rs). 任何合理的现代git（2.x） PATH 作品；git≥2.53（含 # v3 git bundle 标题）也被接受。

防锈工具链

• 支持的最低Rust版本（MSRV）： 1.75-申报 Cargo.toml 作为 rust-version.

任何使用git代理mcp作为库的人只需要1.75或更高版本。

• 固定开发版本： 1.95.0--声明于 rust-toolchain.toml.CI构建、发布、，

和那个 target/release/ 您在本地生成的二进制文件都使用这个确切的版本。运行任何 cargo repo中的命令通过rustup自动安装它。

这种两层方法（松散的MSRV+严格的引脚）为我们的构建提供了可重复性，而无需强制 下游消费者发布特定点。

Git身份验证

将Git配置为在不提示的情况下进行身份验证：

# macOS
git config --global credential.helper osxkeychain

# Windows
git config --global credential.helper manager

# Linux
git config --global credential.helper libsecret

对于SSH，请确保您的密钥在SSH代理中：

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

使用Claude Desktop

添加到您的Claude Desktop MCP配置中：

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

______________________________________________________________________

配置

配置文件位置：

• Linux/macOS： ~/.git-proxy-mcp/config.json
• 窗户： %USERPROFILE%\.git-proxy-mcp\config.json

{
    "git_identity": {
        "name": "Claude AI",
        "email": "ai-assistant@your-domain.com"
    },
    "security": {
        "allow_force_push": false,
        "protected_branches": ["main", "master"]
    },
    "logging": {
        "level": "warn",
        "audit_log_path": "~/.git-proxy-mcp/audit.log"
    },
    "timeouts": {
        "request_timeout_secs": 300
    },
    "limits": {
        "max_output_bytes": 10485760
    },
    "rate_limits": {
        "max_burst": 20,
        "refill_rate_per_sec": 5.0
    },
    "proxy": {
        "url": "http://proxy.example.com:8080",
        "no_proxy": "*.internal.com,localhost"
    },
    "sessions": {
        "timeout_secs": 3600,
        "max_streaming_sessions": 10,
        "max_repo_sessions": 100
    },
    "lfs": {
        "retry_max_attempts": 3,
        "max_object_size": 104857600
    },
    "submodules": {
        "exclude_patterns": ["vendor/*"]
    }
}

有关显示每个部分和选项的完整填充示例，请参阅 config/example-config.json.

配置选项

______________________________________________________________________

贡献

欢迎投稿！看 贡献.md 作为指导方针。

• 按照中的风格指南进行操作 风格.md
• 安全问题：请参阅 安全.md

______________________________________________________________________

许可证

版权所有（C）2026 Matej Gomboc .

GNU通用公共许可证v3.0--请参阅 许可证.

______________________________________________________________________

链接

• MCP规范
• git2（libgit2-Rust绑定）
• 报告问题