GitGuardian MCP Server

官方

将 GitGuardian 的秘密检测与事件管理带入 AI 智能体

分类: 开发工具第 227 / 438
Stars: ★ 40 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: 远程托管（无需本地环境） · Python · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 11 天前
工具数: 4

52FMRS · D

GitGuardian 官方维护的 MCP 服务器，将密钥检测、事件管理与蜜标能力接入 AI 智能体。支持托管 HTTP、自托管 Docker 与本地 stdio（PAT）三种部署方式，工具集由令牌 OAuth 作用域决定，默认偏只读。使用前需确认区域 URL 与认证模式，注意托管模式下的请求转发路径以及代码修复自动化带来的操作风险。

最强项 · 文档质量 13/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

11/20

文档质量

13/20

安装易用性

8/20

查看各项评分依据

可靠性 8/20: 静态证据显示服务器具备可运行的轮廓：server.json 声明了 PyPI 包 ggmcp 0.7.0，使用 uvx 运行、stdio 传输，README 说明工具集与 OAuth 作用域绑定，并描述了多种部署模式（托管 OAuth 代理、自托管 Docker、本地 stdio PAT）。但缺少可验证的执行证据：仓库摘要未包含任何 CI 工作流或已提交的测试文件，评分规则明确要求有真实 CI 与覆盖关键路径的测试才能给高分，本次仅按源码静态阅读，故可靠度上限受限。另存在版本与能力表述不一致（描述称 600+ 检测器，manifest 与 README 称 500+），以及 stdio 默认仍为已弃用的浏览器 OAuth 路径，属于潜在的初始化与认证路径不稳定因素；错误处理、依赖可控性与握手可复现性均无证据。综合给出 8 分。
安全与权限 12/20: 无红线证据：未发现恶意代码、凭据窃取、隐蔽外传、未确认的不可逆删除/支付/部署默认行为，也未在 README 中出现真实令牌（示例使用占位符 your_pat_here）。最小权限方向有正面证据：README 明确服务器默认倾向只读权限，实际暴露工具取决于 OAuth 作用域或 PAT 作用域；托管模式使用 RFC 9728 OAuth 保护资源代理。但扣分点明确：访问 GitGuardian 云端的令牌与 PAT 处理细节、是否落盘（旧 stdio OAuth 会在本地磁盘存储 PAT）、日志与数据边界未在可见材料中说明；写操作（创建蜜罐令牌、打开修复 PR、修改事件）未见显式确认机制；托管路径会让请求经由 mcp.gitguardian.com 与 api.gitguardian.com 两个第三方端点，数据流披露仅一句带过。权限与确认机制不完整，故给 12 分。
维护活跃度 11/20: 维护活跃度中等偏正面：有 MIT 许可证，版本号明确为 0.7.0，README 包含迁移说明、弃用路径（developer-mcp-server、secops-mcp-server）与 DEVELOPMENT.md 指引，显示存在持续迭代；仓库未归档，有 25 个未关闭 issue，说明有用户反馈但响应情况不可见。扣分因素：无法从所给材料看到具体提交节奏、发布历史、依赖更新策略或安全响应通道（如 SECURITY.md），治理与版本化细节缺失；issue 数量相对星数偏高可能反映积压。依据只读、仅凭给定证据、缺失即为扣分的原则，给 11 分。
文档质量 13/20: 文档质量较好但存在隐藏假设。优点：README 分层清晰，覆盖安装（Cursor、Claude Desktop、Claude.ai、Windsurf、Zed 五种客户端配置示例）、四种认证模式对照表、完整配置变量参考表（含默认值）、自托管 Docker 命令、迁移说明与开发文档入口，示例均为占位符而非真实密钥，并明确披露 stdio OAuth 已弃用及未来移除计划。扣分点：无工具级参数说明（仅说工具集取决于作用域，未列出工具清单与入参）；无成本/配额说明；无故障排查章节；能力描述内部不一致（600+ 与 500+ 检测器）；自托管文档自称“即将开箱可用”，当前实际步骤与实际状态之间存在落差。综合给 13 分。
安装易用性 8/20: 安装路径存在但偏手动且易出错。server.json 提供 uvx + stdio 的单命令包运行方式，README 为五种主流客户端给出可复制 JSON 配置，托管 OAuth 路径号称无需本地安装与令牌管理，属明显优势。扣分点：静态评分上限 15，且无 CI/测试证据支撑，故不能给高分；本地 stdio 需要用户自行在仪表盘创建 PAT 并手工写入配置；macOS 上 Claude Desktop 需要 uvx 绝对路径（文档自述不解析 $PATH），是已知的脆弱点；自托管需自行编写 Docker 命令、配置反代终止 TLS、并显式设置 IS_ON_PREM 才能避免主机名猜测失败；四种认证模式与多个环境变量组合对普通用户认知负担较大。综合给 8 分。

静态评测 · 未实际运行收录于 2026-09-10

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

已在 GitGuardian SaaS（US/EU）或自托管实例上使用 GitGuardian 的团队
希望在 IDE 或聊天客户端内进行密钥扫描、事件分流与修复的开发者
需要自动化修复密钥并打开拉取请求的团队
使用支持 type: http 的 MCP 客户端、可接受 OAuth 流程的用户
CI/CD、脚本或气隙环境等需要本地 stdio 加 PAT 的场景

不适合谁

未使用 GitGuardian 且不希望接入其 API 的用户
只使用旧版 MCP 客户端、不支持 type: http 且不愿采用本地 stdio 的用户
期望无需任何认证或作用域配置即可直接使用的用户
希望 MCP 服务器完全不经由 mcp.gitguardian.com 转发的托管服务用户（此类场景应选择自托管）

所需权限

需要 GitGuardian 访问令牌（OAuth 或 PAT），实际工具集由令牌持有的 OAuth 作用域决定
本地 stdio 模式使用 GITGUARDIAN_PERSONAL_ACCESS_TOKEN 环境变量
自托管 OAuth 代理模式会代理 /authorize、/token、/register 到 GitGuardian dashboard
PAT 默认有效期为 30 天，可通过 GITGUARDIAN_TOKEN_LIFETIME 配置
服务器默认采用偏只读的权限设置

风险与副作用

MCP 服务器是新兴技术，智能体会代表用户行动并由用户承担责任
托管 MCP 模式下请求会额外经由 mcp.gitguardian.com 转发，而不只是 api.gitguardian.com
访问令牌的作用域决定暴露给智能体的工具范围，作用域过大可能扩大影响面
代码修复自动化会创建拉取请求，需审查智能体的操作
stdio 模式的浏览器 OAuth 流程已被弃用并会将 PAT 存储在磁盘上，未来版本将移除该路径

安装接入

准备工作

运行环境：远程托管（无需本地环境） · Python · Docker

GITGUARDIAN_PERSONAL_ACCESS_TOKEN 可选密钥 GitGuardian 个人访问令牌，在 GitGuardian 控制台 API → Personal Access Tokens 创建，stdio/CI 模式必用。

其他可选配置项（11 个）

GITGUARDIAN_URL 可选 GitGuardian dashboard 地址，默认 https://dashboard.gitguardian.com（美国 SaaS），自托管需改。

GITGUARDIAN_CLIENT_ID 可选自定义 OAuth 应用的 client ID，默认 ggshield_oauth。

GITGUARDIAN_SCOPES 可选请求的 OAuth scopes（逗号分隔），默认自动检测。

GITGUARDIAN_TOKEN_NAME 可选 OAuth 签发 PAT 的显示名，默认 MCP Token。

GITGUARDIAN_TOKEN_LIFETIME 可选 PAT 有效期天数（或 never），默认 30。

IS_ON_PREM 可选 true 表示自托管 GitGuardian；不设则按主机名猜测。

MCP_PORT 可选 HTTP 传输监听端口，未设则用 stdio。

MCP_HOST 可选 HTTP 传输绑定地址，默认 127.0.0.1。

MCP_BASE_URL 可选本 MCP 服务器的公开 URL（OAuth 代理模式），默认 http://localhost:8000。

MCP_OAUTH_PROXY_ENABLED 可选 true 时以 RFC 9728 OAuth Protected Resource 模式发布并将 authorize/token 代理到 dashboard。

ENABLE_LOCAL_OAUTH 可选旧版 stdio OAuth 流程开关（已弃用），默认 true。

推荐使用托管服务器：在 MCP 客户端配置中填写与 GitGuardian 区域匹配的 URL，客户端会自动处理 OAuth。例如 Cursor 编辑 ~/.cursor/mcp.json：{"mcpServers":{"GitGuardian":{"type":"http","url":"https://mcp.gitguardian.com/mcp"}}}；Windsurf 使用 {"mcp":{"servers":{"GitGuardian":{"type":"http","url":"https://mcp.gitguardian.com/mcp"}}}}；Claude.ai 网页版在 Settings → Connectors → Add custom connector 中添加该 URL；Claude Desktop 与 Zed 使用同样的 type: http 配置。若需本地 stdio（PAT）模式，使用命令 uvx --from git+https://github.com/GitGuardian/ggmcp.git gg-mcp-server，并设置 ENABLE_LOCAL_OAUTH=false、GITGUARDIAN_PERSONAL_ACCESS_TOKEN 与 GITGUARDIAN_URL；在 macOS 的 Claude Desktop 中，command 需填写 uvx 的绝对路径。自托管可运行 ghcr.io/gitguardian/mcp-server 镜像并置于终止 TLS 的反向代理之后，默认在 8000 端口提供 StreamableHTTP。

.cursor/mcp.json

{"mcpServers":{"GitGuardian":{"type":"http","url":"https://mcp.gitguardian.com/mcp"}}}

以 Cursor 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "GitGuardian": {
      "type": "http",
      "url": "https://mcp.gitguardian.com/mcp"
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add --transport http GitGuardian https://mcp.gitguardian.com/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端连接 https://mcp.gitguardian.com/mcp 完成 OAuth 后，工具列表中应出现 secret_scanning、incident_management、honeytokens、code_fix_automation 等工具；或发送“扫描这个代码库有没有泄露的密钥”验证调用是否成功。

常见排障

确认所选 URL 与 GitGuardian 区域匹配：US 使用 https://mcp.gitguardian.com/mcp，EU 使用 https://mcp.eu1.gitguardian.com/mcp
自托管部署若域名位于 gitguardian.com/gitguardian.tech 之下，需显式设置 IS_ON_PREM=true，否则主机名推断会失败
本地 stdio 模式需设置 ENABLE_LOCAL_OAUTH=false 并提供 GITGUARDIAN_PERSONAL_ACCESS_TOKEN
macOS 的 Claude Desktop 需要 uvx 的绝对路径，它不会解析 $PATH
若工具缺失，检查访问令牌的 OAuth 作用域
过旧的客户端不支持 type: http，可使用本地 stdio 回退方案
developer-mcp-server 与 secops-mcp-server 已弃用，应改为直接调用 gg-mcp-server

试试这样问

连接成功后，可以直接对 AI 助手这样说：

扫描这个代码库里有没有泄露的密钥或凭据。
检查有没有分配给我的新安全事件。
帮我理解这个安全事件并提供修复步骤。
创建一个名为 dev-database 的 honeytoken 并藏进配置文件里。

工具能力 4

secret_scanning 只读

主动扫描文件以发现泄露的凭据

incident_management 写入

列出、筛选、指派、解决和标记安全事件，包括内部事件与 Public Monitoring 事件

honeytokens 写入

生成蜜标并列出已有蜜标

code_fix_automation 写入

针对工作区监控的仓库创建修复密钥的拉取请求

使用场景

扫描代码库中泄露的密钥或凭据

修复与某个项目相关的所有安全事件

查看是否有新指派给自己的工作区安全事件

理解某个安全事件并获取修复步骤

列出所有活跃的蜜标

生成用于监控 AWS 凭据访问的蜜标

创建名为 dev-database 的蜜标并隐藏在配置文件中

支持客户端

Cursor

Claude Desktop部分支持

Claude.ai

Windsurf

Zed

依据项目文档列出，未经本站实测。

详细介绍

GitGuardian MCP Server 由 GitGuardian 官方维护，将 GitGuardian 的密钥检测与安全事件管理能力接入 AI 智能体。它使用 GitGuardian API 与 500+ 检测器，支持在代码公开前扫描文件中的凭据泄露、查看与管理安全事件（包括内部事件与 Public Monitoring 事件）、生成与列示蜜标（honeytokens），以及自动创建修复密钥的拉取请求。服务器默认采用偏只读的权限，实际暴露的工具集由访问令牌持有的 OAuth 作用域决定。可通过托管 HTTP 服务（US 区域 https://mcp.gitguardian.com/mcp，EU 区域 https://mcp.eu1.gitguardian.com/mcp）、自托管 Docker 镜像或本地 stdio（PAT）方式运行。