CodeInspectus 是由 Synvoya 开发的本地优先、隐私保护的安全 MCP 服务器与 CLI。它面向 AI 生成的“氛围编程”代码,可被 Claude Code、Cursor、Codex 等 AI 编程代理调用,实现扫描 → 修复 → 重新扫描的闭环,全程在本机进行,无需账户,扫描时零网络出口。
主要能力方面,CodeInspectus 将三个业界开源引擎统一到一个按 CWE 键控的规范化模式之下:Opengrep 负责 SAST / OWASP Top 10(SARIF);Gitleaks 负责密钥检测;Trivy 负责依赖 CVE(SCA)、IaC 错误配置、密钥、许可证与 SBOM。同时,它添加了通用扫描器容易遗漏的 AI 代码专项检查,例如客户端密钥/打包暴露、Supabase RLS / 反向认证(CVE-2025-48757 类)、提示注入汇聚点、模型生成的工具参数未经守卫到达 Node、Python 以及有限支持的 Go、Java、C#、PHP、Rust、Ruby shell 汇聚点、模型输出到达 JavaScript eval / Function、缺少可见认证或服务端授权的 Next.js 与 Express 管理 API 处理器、Supabase Edge Functions 匿名部署但缺少请求认证或特权操作授权、客户端可写 user_metadata 授权、未净化模型/用户输出通过 dangerouslySetInnerHTML 渲染(XSS / LLM05),以及 API 边界泄露、原始请求直写数据库、敏感日志和基于证据的安全头/CSP/Referrer-Policy/Permissions-Policy/会话 cookie/Supabase CAPTCHA 配置检查。此外还有针对 Flutter/Dart、Android/iOS、React Native、Expo、Python AI/API、Go、Java、C#、PHP、Rust、Ruby、Firebase 配置和 GitHub Actions 工作流的专用规则包。
随附清单包含 94 条精选检测:72 个第一方原生规则 ID、18 条 Opengrep 拥有的 SAST 规则和 4 条自定义 Gitleaks 规则。Opengrep、Gitleaks 和 Trivy 为可选、受管、增量式引擎。CodeInspectus 会在请求许可前说明各引擎的覆盖范围、许可证、平台特定体积和所需操作;批准后下载官方 SHA 固定的引擎二进制文件,存放在 npm 包之外,并作为本地子进程调用。
使用方式上,前提是 Node.js ≥22,推荐 Node 24 LTS。首次裸运行 npx codeinspectus 会打开引导式设置;MCP 客户端通过管道 stdio 启动,暴露 codeinspectus_setup,代理需请求计划、展示并获取许可,再以 confirm_downloads=true 调用安装。设置阶段仅下载缺失、不匹配或新固定版本的二进制文件,校验不可变锁文件后原子化安装到 ~/.codeinspectus/;离线 Trivy 漏洞库仅在缺失、无重扫来源或超过七天时刷新。每次扫描和 codeinspectus_list_rules 响应都包含结构化 engine_setup 状态:ready、repair_required、db_refresh_recommended 或 unsupported_platform。
支持 CLI、CI 和本地证据工作流:Git 范围扫描保留完整仓库上下文,标记变更与支持上下文发现,报告精确已解决修订和显式完整性限制,且从不检出、重置、暂存或修改仓库;密封包保留脱敏 JSON、SARIF、Markdown、覆盖率、来源和带内容哈希的附加规范扫描记录,导出或比较前必须验证;CSV 是规范 JSON 模型的确定性电子表格安全投影,始终保留显式扫描/覆盖行,并中和公式触发单元格;V2 TypeScript SDK 可从 codeinspectus/sdk 获取。批量模式扫描已存在的仓库,受控并发、每仓库隔离和原子可恢复清单;仓库历史模式需单独选择加入,要求精确修订、UTC 日期和提交数边界。
适用场景包括 AI 生成应用的发布前安全审查、CI 门禁、本地扫描历史比较、基线强制、问题适配器生成脱敏的 GitHub、Jira 或 Linear JSON 载荷等。限制方面,部分上游 Opengrep 资产在 Linux 上需要 glibc,Alpine/musl 不适用 Opengrep;官方 @contentauth/c2pa-node 验证器为可选对等依赖,需显式安装;Trivy DB 在 0.3.2 之前安装时需运行一次设置以启用 CVE 重扫跟踪;缺失事实暂未提供。