AgentGuard — security checks for AI agents

AgentGuard — AI Agent 的安全检查（MCP 服务）

一个免费、开源的单二进制文件 MCP 服务，为任何 AI Agent（Claude Desktop、Cursor、Claude Code，……）提供嵌入工作流中的安全检查：

工具	功能	数据来源
scan_secrets	在 Agent 提交、记录日志或发送文本／代码／差异之前，标记其中硬编码的机密（API 密钥、令牌、私钥）。在本地运行；值会被屏蔽。	本地（正则表达式 + 熵）
check_cve	检查特定软件包版本是否存在已知 CVE，并提供严重性和修复版本。	OSV.dev（免费）
scan_dependencies	扫描 go.mod / package.json / requirements.txt，并报告所有固定版本中存在漏洞的依赖项。	OSV.dev（免费）

无需 API 密钥，无需账户，不收集遥测数据。除 CVE 查询会调用免费的公开 OSV.dev API 外，所有操作都在本地运行。

安装

选择适合你设置的方式。三种方式提供的都是相同的 stdio MCP 服务。

Docker（无需 Go 工具链）

docker run -i --rm ghcr.io/shuaicongxiaomai/agentguard:latest demo

MCP 客户端配置（Claude Desktop / Cursor / Claude Code 中的 mcpServers 配置块）：

{
  "mcpServers": {
    "agentguard": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/shuaicongxiaomai/agentguard:latest"]
    }
  }
}

Go 安装

go install github.com/shuaicongxiaomai/agentguard@latest

{ "mcpServers": { "agentguard": { "command": "agentguard" } } }

预构建二进制文件

从 Releases 页面下载适用于你操作系统和架构的压缩包，解压后，将配置中的 command 指向二进制文件的绝对路径。

从源代码构建

go build -o agentguard .          # append .exe on Windows

三种运行方式

1. demo — 零配置查看运行效果：

agentguard demo

使用示例输入运行全部三种工具并打印结果。

2. stdio（默认）— 本地使用；MCP 客户端会启动二进制文件。 无需端口； 客户端负责管理其生命周期。使用上述任一配置，然后向 Agent 提问： “扫描其中的机密”、“lodash 4.17.20 是否存在漏洞？”、 “检查我的 package.json 中是否有存在漏洞的依赖项。”

3. serve — 在端口上运行 Streamable HTTP 服务（用于托管／远程服务）：

agentguard serve :8080          # or set PORT=8080
# health:   GET  http://host:8080/healthz
# MCP URL:  POST http://host:8080/mcp   (clients connect to this URL)

本地使用时请使用 stdio；如果你想运行一个托管服务，让用户无需安装任何内容即可通过 URL 连接，请使用 serve。

说明

• scan_secrets 在本地运行，绝不会返回未屏蔽的机密值——只会返回经过屏蔽的预览。
• scan_dependencies 每次调用最多处理 200 个依赖项，并发查询 OSV。
• check_cve / scan_dependencies 需要网络访问 OSV.dev；scan_secrets 完全离线运行。

许可证

MIT。