affaan-m/agentshield

AI agent security scanner. Detect vulnerabilities in agent configurations, MCP servers, and tool permissions. Available as CLI, GitHub Action, ECC plugin, and GitHub App integration. 🛡️

解决的问题

AgentShield 是一款专为保护 AI 代理配置而设计的安全审计工具，特别针对 Claude Code 配置。它解决了开发人员在安装社区技能、连接 MCP（模型上下文协议）服务器或配置钩子时，可能未意识到其中包含硬编码的密钥、权限过度开放或可能导致远程代码执行（RCE）或数据泄露的提示注入向量的风险。

工作原理

AgentShield 会扫描 .claude/ 目录及相关的配置文件，利用跨 15 个模块的 268 条规则库识别漏洞。它分析以下几个关键领域：

密钥检测：搜索硬编码的 API 密钥（Anthropic、OpenAI 等）、令牌和凭据。
权限审计：标记通配符访问（例如 Bash(*)）以及危险命令缺少拒绝列表的情况。
钩子分析：检测代理钩子中的命令注入、数据外泄模式和反向 Shell。
MCP 服务器安全：识别高风险服务器、供应链风险（如 npx -y 自动安装）以及不安全的网络绑定。
代理配置审查：扫描 CLAUDE.md 和子代理配置中的提示注入表面、隐藏指令以及危险的自动运行指令。

它提供等级制安全报告（A 到 F），并可作为 CLI 工具、GitHub Action 或 GitHub App 集成。还支持使用 Claude Opus 的对抗性分析模式。

适用人群

专为使用 AI 代理（尤其是 Claude Code）的开发人员和安全工程师设计，帮助他们在部署前确保代理配置和第三方扩展的安全性。

主要亮点

全面的规则集：涵盖密钥、权限、钩子、MCP 服务器和代理提示的 268 条规则。
灵活的集成方式：可通过 npm（npx）、全局安装、GitHub Action 和 GitHub App 使用。
自动修复功能：包含 --fix 标志，可自动将硬编码密钥替换为环境变量引用。
上下文感知评分：使用 runtimeConfidence 区分运行时配置与模板或示例，避免因文档导致评分不公。
供应链验证：可查询 npm 注册表，检查 MCP 包的来源和健康状况。