Agent Skill Scanner

agent-skill-scanner MCP 服务

最后更新：2026-03-31

直接通过 Claude Code 扫描 OpenClaw SKILL.md 和 Model Context Protocol（MCP）工具定义文件中的安全漏洞。

22 条检测规则，涵盖提示词注入、能力升级、数据外泄、编码载荷和组合风险。这是唯一专门针对 Agent 技能文件格式的扫描器。通用静态应用安全测试（SAST）工具无法检测出这些格式中的任何问题。

安装

需要 Python 3.10+ 和扫描引擎：

pip install agent-skill-scanner

在 Claude Code 中配置

将以下内容添加到 Claude Code MCP 设置中：

{
  "mcpServers": {
    "agent-skill-scanner": {
      "command": "python3",
      "args": ["/path/to/agent-skill-scan-mcp/server.py"]
    }
  }
}

将 /path/to/ 替换为克隆此仓库的实际路径。

工具

scan_skill_file

扫描单个技能文件中的安全漏洞。

scan_skill_file(file_path="/path/to/SKILL.md")

返回包含严重程度、规则 ID、描述和证据的发现结果。

scan_directory

递归查找并扫描目录中的所有 Agent 技能文件。

scan_directory(directory_path="/path/to/skills/")

返回所有已发现技能文件的汇总发现结果。

检测内容

22 条规则，涵盖 5 个类别：

类别	示例
提示词注入	系统提示词覆盖、角色劫持、指令注入
能力升级	权限提升、启动 shell、持久化机制
数据外泄	访问凭据、读取环境变量、向外传输
编码载荷	Base64 命令、十六进制载荷、混淆字符串
组合风险	不受限制的工具链式调用、跨技能数据流、信任违规

差异化优势

此扫描器专门针对 OpenClaw SKILL.md 和 MCP 工具定义格式——通用 SAST 工具（semgrep、CodeQL）完全无法检测的 Markdown 嵌入代码和 YAML 技能配置。如果要扫描通用 Python/JavaScript 代码，请使用 Snyk 或 semgrep。如果要扫描 Agent 技能文件，这是唯一支持此格式的工具。

信任与安全

此服务通过 stdio 在本地运行。除了初始的 pip install，不会进行任何网络调用。不会收集数据，也不会进行遥测。

此仓库中的源代码完全可供审查。扫描引擎源代码位于 github.com/rexcoleman/agent-skill-scanner。

限制

• 仅基于模式检测，不进行语义分析
• 专为 OpenClaw SKILL.md 和 MCP 工具定义设计
• 规则涵盖已发表研究中记录的已知攻击模式，不涵盖零日漏洞

链接

• 扫描器（PyPI）： agent-skill-scanner
• GitHub Action： agent-skill-scan-action
• 研究： rexcoleman.dev

许可证

MIT