agent-guard-mcp

agent-guard-mcp

MCP 服务（使用 Go 编写，单个静态二进制文件），用于感知 Git 状态的安全文件操作。让你的 AI Agent（Claude Code、GitHub Copilot CLI、Cursor、……）可以自由删除它们创建的内容，同时确保它们无法删除 Git 跟踪的源代码。

**策略：**任何内容都可以删除，直到被 Git 仓库跟踪为止。

工具

工具	用途
safe_delete	删除文件／目录；拒绝删除 Git 跟踪的文件或包含此类文件的目录。支持 dry_run。
check_protection	报告路径是否受保护及其原因。
guard_status	汇总目录：已跟踪（受保护）与未跟踪（可删除）的数量。

安装

构建单个静态二进制文件（无运行时依赖）：

go build -o agent-guard-mcp .

或直接安装：

go install github.com/kavachh/agent-guard-mcp@latest

Claude Code

claude mcp add agent-guard -- /path/to/agent-guard-mcp

GitHub Copilot CLI

在 ~/.copilot/mcp-config.json 中：

{
  "mcpServers": {
    "agent-guard": { "command": "/path/to/agent-guard-mcp", "args": [] }
  }
}

任何 MCP 客户端（通用 stdio 配置）

{ "command": "/path/to/agent-guard-mcp", "args": [] }

推荐的 Agent 指令

添加到你的 CLAUDE.md / AGENTS.md / .github/copilot-instructions.md：

不要在 shell 中使用 rm。始终使用 safe_delete MCP 工具删除文件，它会保护 Git 跟踪的源代码。

由于 safe_delete 绝不会销毁已跟踪的源代码，因此可以在客户端的权限设置中安全地自动批准此服务的工具。

示例

safe_delete { "paths": ["build/", "scratch.txt"] }
→ deleted (untracked)

safe_delete { "paths": ["src/main/java/App.java"] }
→ BLOCKED: git-tracked source file — use `git rm` deliberately if intended

要求

• PATH 中有 git
• Go ≥ 1.24（仅构建时需要——二进制文件本身没有任何依赖）

测试

24 个用例的边界测试套件（已跟踪／已暂存／已忽略的文件、嵌套仓库、符号链接、试运行，……）：

go build -o agent-guard-mcp . && npm test