内容
# agentguard-mcp
**用于 [`@mukundakatta/agentguard`](https://www.npmjs.com/package/@mukundakatta/agentguard) 的 MCP 服务器。** 让 Claude Desktop、Cursor、Cline、Windsurf、Zed 或任何其他 MCP 客户端在进行任何 fetch 请求之前检查某个 URL 是否符合网络出口策略。
```bash
npx -y @mukundakatta/agentguard-mcp
```
三种工具：
- **`check_url`** — 单个 URL 检查：返回 `{ allowed, reason }` 而不进行实际请求。
- **`check_urls_batch`** — 批量检查每个 URL 的决策结果以及汇总信息。
- **`validate_policy`** — 检查策略规范是否有空的允许列表、过宽的 `*` 通配符和错误的域名模式。
## 添加到您的客户端
### Claude Desktop
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"agentguard": {
"command": "npx",
"args": ["-y", "@mukundakatta/agentguard-mcp"]
}
}
}
```
与 Cursor (`~/.cursor/mcp.json`)、Cline、Windsurf、Zed 配置格式相同。
## 工具示例
**`check_url`：**
```json
{
"url": "https://api.openai.com/v1/chat",
"policy": { "allow": ["api.openai.com", "*.anthropic.com"] }
}
```
返回：
```json
{ "allowed": true, "reason": "matched_allowlist", "detail": null }
```
**`check_urls_batch`：**
```json
{
"urls": [
"https://api.openai.com/v1/chat",
"https://evil.example.com/leak"
],
"policy": { "allow": ["api.openai.com"] }
}
```
返回：
```json
{
"results": [
{ "url": "https://api.openai.com/v1/chat", "allowed": true, ... },
{ "url": "https://evil.example.com/leak", "allowed": false, "reason": "not_in_allowlist", ... }
],
"summary": { "total": 2, "allowed_count": 1, "denied_count": 1 }
}
```
**`validate_policy`：**
```json
{ "policy": { "allow": ["*", "https://api.example.com", "api.example.com/v1"] } }
```
返回关于 `*` 通配符、scheme 前缀和路径后缀的错误信息 — 编写策略时常见的错误。
## 为什么使用单独的 MCP 服务器
`@mukundakatta/agentguard` 是一个零依赖的 JavaScript 库。此 MCP 服务器使其决策引擎可被任何支持 MCP 的 AI 助手访问：询问 Claude “我的代理的工具列表是否符合此防火墙？”或“这 50 个 URL 中哪一个会被我的策略阻止？”助手可以直接调用这些工具。
注意：此 MCP 服务器仅**检查** URL — 它实际上并不包装 fetch 请求或阻止真实请求。要进行运行时强制执行，请直接在 Node 进程中使用 `@mukundakatta/agentguard`。
## 相关 MCP 服务器
agent-stack 系列的一部分：
- [`@mukundakatta/agentfit-mcp`](https://www.npmjs.com/package/@mukundakatta/agentfit-mcp) — *Fit it.*
- [`@mukundakatta/agentguard-mcp`](https://www.npmjs.com/package/@mukundakatta/agentguard-mcp) — *Sandbox it.*（此项目）
- [`@mukundakatta/agentsnap-mcp`](https://www.npmjs.com/package/@mukundakatta/agentsnap-mcp) — *Test it.*
- [`@mukundakatta/agentvet-mcp`](https://www.npmjs.com/package/@mukundakatta/agentvet-mcp) — *Vet it.*
- [`@mukundakatta/agentcast-mcp`](https://www.npmjs.com/package/@mukundakatta/agentcast-mcp) — *Validate it.*
## 许可证
MIT
