使用
Linux x86_64
透過 npm 全域安裝 mcp-guard
npm install -g @permission-protocol/mcp-guard
確認能用
mcp-guard --help輸出應包含「mcp-guard — MCP policy proxy」。
先試試這個
mcp-guard demo加進你的 agent
claude mcp add mcp-guard -- mcp-guard --config pp.config.yaml -- node my-mcp-server.jsClaude Desktop、Cursor 等用戶端用的 JSON
{
"mcpServers": {
"mcp-guard": {
"command": "mcp-guard",
"args": [
"--config",
"pp.config.yaml",
"--",
"node",
"my-mcp-server.js"
]
}
}
}執行 mcp-guard demo,透過範例工具觀看代理的實際運作。
它能做什麼
- 在不安全的工具呼叫執行前加以阻擋沒有看到它可用
- 暫停敏感操作等待人工核准沒有看到它可用
- 將決策簽署為 Ed25519 收據沒有看到它可用
- 在 observe 模式下稽核政策沒有看到它可用
pickfit 測到哪一步
Linux x86_64
- 可以安裝
- 可以連線
- 4 項功能中 0 項可用
- 可離線使用
適合用來
- 阻擋刪除使用者資料
- 正式環境部署需經核准
- 在 observe 模式下稽核會被阻擋的項目
可替代 API gateway 和 RBAC / IAM。
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
Linux x86_64
MCP 用戶端成功呼叫工具
- 從頭重跑
- 可離線使用
- 檢查於 2026年10月30日
MCP 用戶端透過 stdio 連線,列出 3 個工具,呼叫 safe_tool 也回傳了結果。
測試機器遇到的差異
- README: npm install @permission-protocol/mcp-guard
測試中: npm install -g @permission-protocol/mcp-guard,讓 mcp-guard 位於 PATH(~/.local/bin) - README: mcp-guard --config pp.config.yaml -- node my-mcp-server.js
測試中: 首次執行前先執行 mcp-guard keys init;否則 guard 會以 SIGNING_KEY_MISSING 拒絕啟動 - README: enforce blocks/holds per rules
測試中: 使用 mode: observe(或 --mode observe),讓被阻擋/暫停的工具仍會轉送,probe 回報 tools/call: ok;在 enforce 模式下,阻擋回傳 -32001,暫停回傳 -32002