agent-guard-mcp

agent-guard-mcp

Go で記述された、git を認識した安全なファイル操作のための MCP サーバーです（単一の静的バイナリ）。AI エージェント（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": [] }

エージェントへの推奨指示

CLAUDE.md / AGENTS.md / .github/copilot-instructions.md に追加します。

シェルで rm は絶対に使わないでください。ファイルを削除する場合は、git で追跡されているソースコードを保護する safe_delete MCP ツールを必ず使用してください。

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