{
  "markdown": "# agent-guard-mcp\n\nMCP server (written in **Go**, single static binary) for **git-aware safe file operations**. Give your AI agents (Claude Code, GitHub Copilot CLI, Cursor, …) free rein to delete what they build — while making it impossible for them to delete your git-tracked source code.\n\n**Policy:** anything is deletable *until* it's tracked by a git repository.\n\n## Tools\n\n| Tool | Purpose |\n|---|---|\n| `safe_delete` | Delete files/dirs; refuses git-tracked files or dirs containing them. Supports `dry_run`. |\n| `check_protection` | Report whether paths are protected and why. |\n| `guard_status` | Summarize a directory: tracked (protected) vs untracked (deletable) counts. |\n\n## Install\n\nBuild the single static binary (no runtime dependencies):\n```bash\ngo build -o agent-guard-mcp .\n```\nOr install directly:\n```bash\ngo install github.com/kavachh/agent-guard-mcp@latest\n```\n\n### Claude Code\n```bash\nclaude mcp add agent-guard -- /path/to/agent-guard-mcp\n```\n\n### GitHub Copilot CLI\nIn `~/.copilot/mcp-config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"agent-guard\": { \"command\": \"/path/to/agent-guard-mcp\", \"args\": [] }\n  }\n}\n```\n\n### Any MCP client (generic stdio config)\n```json\n{ \"command\": \"/path/to/agent-guard-mcp\", \"args\": [] }\n```\n\n## Recommended agent instructions\n\nAdd to your `CLAUDE.md` / `AGENTS.md` / `.github/copilot-instructions.md`:\n\n> Never use `rm` in the shell. Always delete files with the `safe_delete` MCP tool, which protects git-tracked source code.\n\nSince `safe_delete` can never destroy tracked source, it is safe to auto-approve this server's tools in your client's permission settings.\n\n## Example\n\n```\nsafe_delete { \"paths\": [\"build/\", \"scratch.txt\"] }\n→ deleted (untracked)\n\nsafe_delete { \"paths\": [\"src/main/java/App.java\"] }\n→ BLOCKED: git-tracked source file — use `git rm` deliberately if intended\n```\n\n## Requirements\n\n- `git` on PATH\n- Go ≥ 1.24 (build only — the binary itself has zero dependencies)\n\n## Testing\n\n24-case edge suite (tracked/staged/ignored files, nested repos, symlinks, dry-run, …):\n```bash\ngo build -o agent-guard-mcp . && npm test\n```\n\n",
  "bytes": 2098,
  "sha": "27d6e0ac89b1c2753039750b2d222c4fd536280e8a7b61a721ad02b2d3b46658",
  "repo_slug": "kavachh/agent-guard-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kavachh_agent_guard_mcp_43813b8f/readme"
}