@deepwhale-cn/dsh-agent-scope

Agent 权限边界 —— 查 agent 的工具/文件/网络权限有没有声明、是不是过宽。

不装它会怎样

你的 MCP 配置长这样：

"filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/"] },
"everything": { "command": "npx", "args": ["-y", "mcp-everything"], "allowedTools": ["*"] }

看起来是「配置齐全」，实际上：

① 文件访问路径是 /       → agent 能读写你所有文件（含 ~/.ssh、~/.aws）
② allowedTools: ["*"]    → agent 能调用所有工具（读文件、执行命令、发请求）
③ allowedDomains: "*"    → 被注入后能把数据发到任意地址

Agent 的权限就是它的爆炸半径。 一旦被提示注入控制， 它能做的事 = 你给它的全部权限。

OWASP 把这归为 LLM06 Excessive Agency。

关键词

关键词：Agent 权限 · 工具权限 · 权限边界 · 最小权限 · MCP 权限 · 沙箱 · 白名单 · 爆炸半径 Keywords: agent scope · tool permissions · least privilege · MCP security · excessive agency · sandbox

它查什么

级别	内容	依据
🔴 高	工具权限用通配符 *	最小权限（NIST SP 800-53 AC-6）
🔴 高	文件访问是 / / ~ / 整个用户目录	MCP 文档 · 目录限制建议
🟡 中	网络访问无限制	OWASP LLM06 Excessive Agency
🟡 中	配置里找不到任何权限声明	最小权限 · 权限应显式声明

「没有声明」为什么危险

没有声明通常等于默认全开 —— 而用户看到的只是一个「很干净」的配置文件， 不会意识到 agent 能做所有事。

安装

dsh plugin --profile web add @deepwhale-cn/dsh-agent-scope
# 或纯 CLI
npx @deepwhale-cn/dsh-agent-scope

用法

dsh-agent-scope --demo
dsh-agent-scope --list-rules
dsh-agent-scope --html r.html

边界

• 只审配置，不审 agent 实现 —— agent 代码里怎么用这些权限，本工具看不到。
• 不判断「给得够不够」 —— 只查「有没有声明、有没有明显过宽」。 权限偏大但没用通配符的情况需要人工评审。
• 配置位置各客户端不同 —— 按常见路径找（mcp.json / .mcp.json / settings.json / claude_desktop_config.json）。
• 沙箱是否真生效 需要运行时验证，不在范围内。
• 与 dsh-mcp-audit 分工： 那个查 MCP 服务来源（未锁版本/明文端点），这个查 MCP 权限边界。
• 与 dsh-least-privilege 分工： 那个查容器/云/Web 权限，这个查 agent 权限。

本插件是一个工具。使用者必须遵守所在地区法律法规，对使用本项目造成的任何后果自行承担责任。

---

深鲸网安守护系列（共 31 个）

一个插件做一件事。安全问题是链式的 —— 配套用才完整。

国内合规 ｜ 等保对照 · 日志留存 · 备案公示 · 用户同意 · 个人信息权利 · 未成年人保护 · 影响评估 · 数据分类分级 · 算法备案 · 数据出境 · 国密合规 · AI 内容标识

AI 与 Agent 治理 ｜ AI 输出信任 · 外部内容信任 · MCP 安全 · Agent 权限 · 策略核对 · 可疑指令

数据与凭据 ｜ 敏感数据 · 密钥轮换 · 数据留存 · 配置审计 · 密钥扫描

供应链与构建 ｜ 开源许可 · 依赖投毒 · CI 安全 · 工具审查 · 物料清单

权限与应急 ｜ 最小权限 · 告警外发 · 应急证据包

都在 DSH 插件市场（dsh-plugin.org）、npm 和 deepwhale.org.cn/guard.html 上。