CodeInspectus MCP Server

社区

本地优先的 MCP 安全扫描器，专为 AI 生成的应用设计

分类: 开发工具第 5 / 438
Stars: ★ 48 热门
传输方式: stdio（本地进程）
运行环境: Node.js 22+ · 预编译二进制 cosign on PATH for O
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 19 天前
工具数: 6

75FMRS · B

一个工程纪律突出的本地安全扫描器：SHA 锁定引擎、零扫描时出站、零遥测、密钥脱敏、三态诚实证据模型，并对自身能力边界（收窄的原生规则、AI 起草的合规映射、启发式提示注入检测）做了罕见的坦率披露。适合 AI 编码代理驱动的日常安全闭环；不能替代深度审计、运行时测试或合规认证。MIT 许可，单人（Synvoya）维护，欢迎独立安全社区审查。

最强项 · 文档质量 19/20 最弱项 · 可靠性 11/20

可靠性

11/20

安全与权限

18/20

维护活跃度

13/20

文档质量

19/20

安装易用性

14/20

查看各项评分依据

可靠性 11/20: manifest 中单一 npm stdio 包与 README 工具表逐一对应,版本号3.2.0及详尽的版本历史(v0.3.1到v3.2.0)显示描述的主路径是合理的。但本次审查只是文本审查——未提供实际的CI工作流YAML、测试文件或eval运行结果供核实,只有README中提到的'npm run eval'与E23-E52测试编号。根据静态校准规则,在没有直接查验测试/CI证据的情况下,可靠性不得超过12分。
安全与权限 18/20: 设计体现出较强的最小权限原则:默认只读扫描('从不编辑或删除您的源代码'),密钥预览做脱敏处理,引擎二进制文件经SHA锁定并用cosign验证、验证失败即拒绝执行,任何修复或git操作前都需要明确批准,并声明扫描时零网络出站,例外情况仅限于显式的repair/setup命令。所提供材料中未出现红线行为(无静默破坏性默认操作、无凭证泄露、无虚假声明)。扣分原因是以上均为README/manifest中的自述内容,属于不可信证据,没有实际源代码可供独立核实。
维护活跃度 13/20: 版本号3.2.0并有详尽的发布历史记录(v0.3.1、0.3.2、v1.5.0、v2.1.0、v3.2.0)及维护中的CHANGELOG.md,表明持续迭代开发;附MIT许可证;开放的5个issue和'good first issue'链接显示一定的社区参与度。但该项目明确为单人维护('背后没有公司'),仅37颗star,且未见专门的SECURITY.md或明确的安全响应渠道/时效说明,存在治理与维护者单点风险。
文档质量 19/20: 文档呈现出非常分层的结构:安装前提条件、各客户端(Claude Code、Cursor、VS Code、Codex、Windsurf/Cline/Aider)的注册代码片段、完整的CLI命令参考、明确列出输入输出行为的工具表,以及异常详尽的'诚实声明'章节,逐条列出每个规则和包的确切适用范围与局限(如支持的语言、框架、不检测的场景)。还引用了大量深入文档链接(CI-POLICY、BASELINES-AND-TRIAGE、SCAN-HISTORY、COMPLIANCE-RATIONALE等)。轻微扣分是因为本次静态审查仅限README,无法交叉核实这些链接文档本身的内容。
安装易用性 14/20: 安装流程文档清晰、步骤简明(Node ≥22、可选cosign、`npx codeinspectus repair-engines`),并为六种不同客户端提供了精确的JSON/TOML配置示例,还有明确的`verify-engines`复核命令与`engine_setup`状态报告便于排查问题。根据静态校准规则,在没有可查验的CI/测试证据证明安装流程端到端可用的情况下,安装易用性上限为15分;此分数反映的是流程文档质量高,而非已确认的实际可执行性。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码

适合谁

使用 Claude Code、Cursor、Codex 等 AI 代理快速构建应用、关注安全的开发者
希望在本地离线扫描代码、不上传源码的个人与小型团队
需要将 CWE 级发现映射到合规框架代码可见控制的团队

不适合谁

寻求完整合规认证或运行时安全证明的团队（工具明确不做认证）
需要跨文件/全程序数据流或运行时移动端测试的深度审计场景
无法满足 Node.js ≥22 或不愿安装 cosign 与引擎二进制的受限环境
Essential Eight 合规评估（仅约 1/8 项缓解措施有代码证据）

所需权限

读取项目源码与仓库文件（只读，从不编辑或删除源码）
在 ~/.codeinspectus 下存储引擎数据与扫描历史
可选写入一个 SBOM 文件（受管目录或用户指定路径）
以本地子进程方式调用经 SHA 验证的 Opengrep/Gitleaks/Trivy 二进制
读取 git 状态以报告 git 安全建议；git 操作需用户批准，工具自身从不执行

风险与副作用

提示注入检测为启发式且不成熟，相关发现标记为中等置信度“潜在……”
修复由 AI 代理执行，需人工审查补丁；工具只报告不修改代码
原生规则覆盖范围刻意收窄（多为文件内分析），不应推断比已执行规则包更广的覆盖
合规映射为 AI 起草、维护者复核，社区验证数为 0/96，不可视为审计结论
引擎二进制供应链风险通过 SHA 锁定缓解，但 setup/repair 时仍需网络下载（应验证来源）

安装接入

准备工作

运行环境：Node.js 22+ · 预编译二进制 cosign on PATH for O

前置条件：Node.js ≥22（推荐 Node 24 LTS）；安装 Opengrep 或 Trivy 二进制时需在 PATH 中有 cosign（验证失败即拒绝安装；Gitleaks 按校验和验证，无需 cosign）。在客户端注册一次（如 Claude Code：claude mcp add- codeinspectus '{"command":"npx","args":["-y","codeinspectus"]}'；Cursor 添加到 mcp.；VS Code：code --add-mcp；Codex：codex mcp add 或编辑 config.toml 并建议 tool_timeout_sec = 600）。然后运行 npx codeinspectus repair-engines 安装/修复经哈希验证的引擎与数据库。之后扫描零网络 I/O。可用 npx codeinspectus verify-engines 随时复核二进制。

.mcp.json

{"mcpServers":{"codeinspectus":{"command":"npx","args":["-y","codeinspectus"]}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "codeinspectus": {
      "command": "npx",
      "args": [
        "-y",
        "codeinspectus"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add codeinspectus -- npx -y codeinspectus

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端注册后，先运行 npx codeinspectus repair-engines 安装引擎，然后在客户端工具列表中确认出现 codeinspectus_scan 等六个工具；也可调用 codeinspectus_list_rules 查看活动的检测规则和引擎状态。

常见排障

扫描返回 engine_setup 非 ready：让代理解释状态（repair_required / db_refresh_recommended / unsupported_platform），经批准后运行 npx codeinspectus repair-engines
CVE 复扫跟踪未启用：对 0.3.2 前安装的 Trivy DB，运行一次 repair-engines 重新经验证路径获取数据库
客户端（尤其 Codex）超时：将 tool_timeout_sec 设为 600，因大型仓库扫描可能超过默认 60 秒
原生规则包未运行：检查 pack_coverage 与 detected_technologies——各包需要精确的框架/依赖证据（如 Flutter、openai-php/client、async-openai 等）
验证二进制完整性：npx codeinspectus verify-engines；缺失或失配的二进制会被拒绝执行

试试这样问

连接成功后，可以直接对 AI 助手这样说：

扫描当前项目的安全漏洞，列出所有 CWE 编号的结果
我修复了一些问题，请对上一次扫描重新扫描并对比已解决、剩余和新增的发现
为这个项目生成一份 CycloneDX 格式的 SBOM
解释一下扫描结果中 CI-0001 这个发现的具体原因和修复方法

工具能力 6

codeinspectus_scan 只读

对指定路径执行完整本地扫描（三引擎 + 原生检查），返回以 CWE 为键的发现、检测到的技术栈、原生规则包与 Pub 依赖覆盖、修复建议及运行时控制的三态仓库证据。

codeinspectus_rescan 只读

修复后复扫并与先前扫描对比，输出已解决/仍存在/新引入的结果，附带最新技术与规则包覆盖信息。

codeinspectus_compliance_report 只读

按合规框架生成代码级控制覆盖报告（非认证）。

codeinspectus_explain_finding 只读

对单个发现提供深入解释与完整修复方案。

codeinspectus_generate_sbom 写入

使用 Trivy 加原生 Pub 清单/回退生成 CycloneDX/SPDX SBOM（默认写入受管目录，或指定路径）。

codeinspectus_list_rules 只读

列出活跃检测器、原生规则包清单与规则归属、引擎版本、检测数据库来源与新鲜度，以及结构化的安装/修复状态。

使用场景

在发布前扫描 AI 生成/“氛围编程”应用中的真实漏洞

由编码代理驱动的“扫描→修复→复扫”安全闭环

生成 OWASP、NIST CSF、ISO 27001、SOC 2 等框架的代码级控制覆盖报告

生成本地 SBOM（CycloneDX/SPDX），含 Dart/Flutter pubspec.lock 依赖清单

CI/本地基线与历史扫描对比、密封证据包与 GitHub/Jira/Linear 工单载荷导出

支持客户端

Claude Code

Cursor

VS Code

Codex

Windsurf

Cline

Aider

依据项目文档列出，未经本站实测。

详细介绍

CodeInspectus 是由 Synvoya 维护的本地优先、注重隐私的 MCP 安全扫描器与 CLI。任何 AI 编码代理（Claude Code、Cursor、Codex、Windsurf、Cline、Aider）都可以调用它扫描 AI 生成/“氛围编程”代码中的真实漏洞，将结果映射到合规框架的代码级控制覆盖，并驱动“扫描→修复→复扫”闭环——完全在本地运行，无需账号，扫描时零网络出站。它编排 Opengrep（SAST/OWASP Top 10）、Gitleaks（密钥泄露）、Trivy（依赖 CVE、IaC、SBOM）三个开源引擎，外加自研的 AI 代码专项检查（Supabase RLS/反向授权、提示注入汇点、模型工具参数到达 shell、客户端可写 user_metadata 授权、危险 HTML 渲染、Firebase 公共写、GitHub Actions 工作流风险等），共 88 条精选检测规则，统一为以 CWE 为键的规范化结果。引擎二进制均经 SHA 锁定与签名验证，无遥测；合规映射仅为代码级覆盖，不构成认证。