yotta-verify-mcp

语言：English · 中文

yotta-verify-mcp · 元信MCP (YuanXin MCP)

YottaMeta 为Agent 技能提供的安装前安全扫描器，以 stdio MCP 服务的形式提供。在安装任何技能、插件或 MCP 服务之前，它会运行确定性静态扫描，检查提示词注入、恶意模式、SKILL.md 完整性和权限，并通过 MCP 工具返回判定结果、已审计徽章、CI 门禁和报告。

在 MCP 客户端中配置元信 MCP 服务、将信任扫描接入 Agent / 工作流，或调用 MCP 工具时启用。

零依赖（Python 3.8+ 标准库）；支持 Windows + Linux + macOS；完全本地离线运行——不进行网络调用，也不执行扫描的代码。

它是什么

技能 / 插件市场存在信任问题：一项针对 22,511 个技能的 2025 年调查发现了 140,963 个问题，36% 含有提示词注入。元信 MCP 会在你安装前给出确定性的答案——使用与 yotta-verify 命令行工具相同的扫描，并将其作为四种 MCP 工具提供，供任何 MCP 客户端（Claude、VS Code、Codex、Cursor 等）调用。

它是安装前验证器，不是沙箱，也不是运行时监控器：它只读取文件并输出报告。它绝不执行扫描的代码，扫描时绝不连接网络，也不会修复任何内容。

为什么使用它

优势	说明
安装前建立信任	为任意技能 / MCP 服务提供确定性判定，而不是“相信我”
零依赖	Python 3.8+ 标准库；无需守护进程 / 数据库 / 网络
完全本地离线	扫描磁盘上的目录和 npm tar 包；不会执行或上传任何内容
接入任意 MCP 客户端	标准 stdio MCP 服务——配置服务后即可使用四种工具
生态协同	与 yotta-verify 使用相同的规则表（单一数据源）；判定结果与 yotta-vetter / yotta-security-audit 合并
免费且开源	MIT 许可；整个扫描器免费

MCP 工具

工具	功能
scan_skill	安装前扫描：target（目录 / .tgz / npm 软件包）→ 判定结果 + 严重性计数 + 发现项
generate_badge	已审计徽章：本地 SVG + shields.io URL；纳入 validate / vetter / audit / version / tests 的结果
gate_check	CI 门禁：当最严重级别超过 max_severity 时失败（默认为 medium）
get_report	验证报告：Markdown 或 JSON，格式与命令行工具相同

MCP 客户端配置

MCP 配置为可选项。AI Agent 可以向你展示目标配置文件、准确的 mcpServers JSON 和具体影响，然后等待你明确同意后再写入任何内容。如果你拒绝，可直接使用随附的命令行扫描器；扫描结果不变。

工具参考

scan_skill

在安装前扫描技能目录或软件包。

Param	Type	Required	Meaning
target	string	yes	技能目录路径、.tgz / .tar.gz 路径或 npm 软件包名称（自动通过 npm pack 打包到临时目录，然后扫描）

返回 JSON 结果：判定结果、严重性计数和发现项（提示词注入 / 恶意模式 / SKILL.md 完整性）。

generate_badge

生成经审计的徽章（本地 SVG + shields.io URL）。

Param	Type	Meaning
target	string	可选：扫描此目标以推导判定结果
verdict	string	可选：直接设置判定结果
validate	string	可选：pass / fail（validate-skill 结果）
vetter / audit	string	可选：纳入的外部判定结果
version	string	可选：版本标签。默认为 扫描器（yotta-verify）的版本（例如 0.1.1）
tests	integer	可选：引擎测试数量
out	string	可选：将 SVG 写入此路径

注意：徽章中的 version 字段反映的是捆绑的扫描引擎（yotta-verify）的版本，可能与 MCP 软件包版本不同。传入 version 可覆盖此值。

gate_check

安装前 CI 门禁。

Param	Type	Meaning
target	string	必填：要扫描的目录 / 软件包
max_severity	string	可选：info / low / medium / high / critical（默认为 medium）

返回 pass、verdict、worst、max_severity 和退出 code。

get_report

生成验证报告。

Param	Type	Meaning
target	string	必填：要扫描的目录 / 软件包
format	string	可选：json / markdown（默认为 markdown）
out	string	可选：将报告写入此路径

边界

这是一次本地、离线、静态扫描：

• 目录扫描完全离线——内容绝不会离开你的设备。
• npm 软件包扫描只会将公开软件包下载到临时目录（之后会删除）；不会上传你的内容，也不会执行被扫描的软件包代码。
• 它不执行动态分析，不会修复任何问题，也不会做出最终决定。请将判定结果视为强有力的参考信号，并自行确认是否“安装 / 不安装”。
• 只扫描你获准评估的目标。

安装技能

此软件包还附带一个 SKILL.md，以便 Agent 在获得用户明确同意后，说明如何配置和使用 MCP 服务。 从以下四种方法中任选其一（技能文件来自 npm；如果没有代理，GitHub 可能会很慢）。

方法 1：npm 单行命令（推荐）

# Optional China mirror: npm config set registry https://registry.npmmirror.com
npx -y @yottameta/yotta-verify-mcp --agent <agent-name>      # install to the agent's default user-level skills dir
npx -y @yottameta/yotta-verify-mcp --dir <your-skills-dir>   # point to the skills dir itself (e.g. ~/.codex/skills)

• --agent <name> 会安装到该 Agent 的默认用户级目录；--list 会显示各 Agent 的默认目录。
• --dir <path> 会安装到指定目录。
• 不带参数运行时，安装程序也会启动 MCP 服务：npx -y @yottameta/yotta-verify-mcp。

方法 2：git clone（开发者 / 可使用 git）

git clone https://github.com/YottaMeta/yotta-verify-mcp.git <your-skills-dir>/yotta-verify-mcp

方法 3：GitHub 下载 ZIP（手动 / 无 git）

在 GitHub 仓库 YottaMeta/yotta-verify-mcp 中，点击 Code → Download ZIP，解压后将 yotta-verify-mcp 文件夹放入 Agent 的技能目录。

方法 4：install.sh（多 Agent 单行脚本）

bash install.sh --agent <name>   # install to the agent's default user-level directory
bash install.sh --dir <path>     # install to the given directory
bash install.sh --list           # list agents -> default directories

开发与验证

仓库验证包括 MCP 引擎测试套件和文档授权回归测试：

# MCP engine suite (Python 3.8 / 3.13)
python scripts/test_yotta_verify_mcp.py

# Documentation consent regression
node --test test/docs-consent.test.js

# Run the MCP server directly for debugging
python scripts/yotta_verify_mcp.py

参考资料：references/trust-checklist.md（MCP 服务 / 插件的安装前信任检查清单）。

许可证

MIT © YottaMeta — 参见 LICENSE。