SuperAPI AI 工具集

mcp-inspector

测试与质量

查看项目

更新于 10-16 00:22

技能介绍

本技能用于在分析 MCP 服务器行为时解释 mcpjam 或 MCP Inspector 的输出,把真实协议问题、互操作警告、实现打磨问题和 mcpjam/SDK 产生的伪影区分开来。

交互使用:先探测服务器,server probe --url <url> --quiet --format json,用探测结果了解认证姿态、资源元数据、授权服务器元数据与注册策略。若显示 oauth_required,可用 oauth login --credentials-out <path> 认证,或在专门测试 OAuth 流程时运行 oauth conformance --credentials-out <path>。发现工具用 tools list --url <url> --credentials-file <path> --quiet --format json;带 _meta.ui.resourceUri、旧式 _meta["ui/resourceUri"] 或 openai/outputTemplate 的工具具有交互 UI。调用工具用 tools call --url <url> --tool-name <name> --tool-args <json> --credentials-file <path>,加 --ui 可在 App Builder 渲染结果。非 TTY、智能体和 CI 环境中 --ui 默认不打开浏览器,需加 --open;已由浏览器自动化打开时用 --no-open,禁止启动、开浏览器与发现时用 --attach-only。UI 成功以 inspectorRender.status === "rendered" 为准,而非退出码 0;渲染被跳过时根据 inspectorRender.remediation 或稳定 warning.code 分支,要求渲染为交付物时用 --require-render。

调查流程:从能证明结论的最窄命令开始;可能失败、需要可复用交付物或 CI 留存证据时,给 server probe、server validate、tools call、oauth login 加 --debug-out <path>。认证成功后用 server info、server capabilities、tools list、resources list/read/templates、prompts list/get 检查已连接表面;需要广度快照时用 server doctor --out <path>。涉及 MCP Apps 工具元数据或 ui:// 资源时先跑 apps conformance --quiet --format json。

安全审查分四阶段:观察(只读探测)、激发(行为验证)、利用或确认攻击者收益、清点爆炸半径。严重性分为 high、medium、low、pending、info,证据不足时用 pending 而非拔高。

硬性规则:不得把 toolsMetadata 称为 MCP 服务器字段;不得用已移除的 app/widget 命令做 UI 渲染;用户只给服务器未给工具时不得跳过 tools list 发现;认证可行时不应停在 oauth_required;apps conformance 通过不等于完整 SEP-1865 一致性。官方资料未提供收费、价格与平台信息。