agent-bom 是面向 AI 智能体与 MCP 服务器的开源安全扫描器和自托管控制平面，覆盖 AI、MCP 与云基础设施。其目标用户是负责 AI 智能体和 MCP 服务器的 AppSec 与平台工程师。
主要能力
- 扫描仓库，发现 AI 智能体背后存在漏洞的软件，并将扫描结果与智能体及基础设施上下文关联。
- 依据影响范围（blast radius）与可达性证据对问题进行优先级排序。
- 支持本地扫描，无需账号；提供自托管控制平面，用于集中管理清单、图谱证据、修复与合规。
- 可发现 MCP 客户端，并可通过代理或网关对选定的实时 MCP 工具调用执行策略。
- 支持云账户连接器和集群同步来收集清单；代理和网关部署可增加运行时证据。
- 支持导出 SARIF、CycloneDX、SPDX、JSON 和 HTML 报告；提供 CLI、GitHub Action、REST API 或 MCP 等多种使用方式。
使用方式 在要检查的仓库中运行 agent-bom 扫描。终端会显示清单、发现、覆盖缺口和修复指导。可使用 agent-bom scan . -f sarif -o findings.sarif 保存报告，然后上传并在 CI 中设置门禁。若设置失败，可运行 agent-bom doctor。没有项目时，可运行 agent-bom scan --demo --offline 使用内置示例；示例会触发安全门禁，因此退出码 1 是预期行为，非零退出可能表示安全门禁或不完整评估。离线快速开始会跳过包 CVE 查询，零 CVE 并不代表完全干净；如需带公告支持的发现，应使用内置演示，或先填充公告数据库。
自托管 可从已发布版本检出启动本地试点，打开 http://localhost:3000，然后进入 Connections 或 New Scan。试点绑定回环地址，状态保存在 Docker 卷中。对于云账户，可添加范围受限的只读连接，验证访问后开始扫描；生产使用应采用带身份验证的部署。
面向编码助手 可运行 agent-bom mcp server，默认配置文件提供八个聚焦工具；也可选择用于图谱、云、运行时或审计工作的 MCP 配置文件。可导入现有扫描器报告而不替换其来源证据。若希望隔离调用，可使用 uvx agent-bom scan . 或 uvx agent-bom check requests@2.33.0 --ecosystem pypi 检查依赖，并添加 pre-commit 与 CI 设置以进行重复检查。
信任与证据 发现功能默认使用只读访问。显式的磁盘旁路扫描会创建临时云资源。缺失证据保持不可用或部分状态；控制映射不是审计认证。录制内容使用带标签的样本数据和内置公告，凭据引用是名称而非秘密值，记录的关系不能证明漏洞已被利用或数据访问成功。项目采用 Apache-2.0 许可。当前源代码版本与最新发布版本均为 v0.108.4。
