用途:分析 mcpjam-cli 对 MCP 服务器的 probe、doctor、OAuth、tools、resources、prompts 输出,判断其中哪些是真实协议问题、互操作警告、实现打磨项或 CLI/SDK 产物。默认以原始请求/响应证据优先于规范化便利输出,并将观察、合规问题与安全发现分开。
主要能力:按 MCP 规范强度(MUST/MUST NOT 为强一致性信号,SHOULD/RECOMMENDED 较软,MAY/可选字段通常仅信息性)映射结论;提供快速工作流、安全审查四阶段(观察、触发、利用或确认攻击者收益、清点影响范围)以及安全严重度校准(high/medium/low/pending/info)。输出契约区分普通排查输出与安全审查输出,要求给出结论、严重度、置信度、意义、证据与缺失证据。
使用方式:先用能证明结论的最窄命令。命令可能失败、需要可复用产物或 CI 留存证据时,为 server probe、server validate、tools call、oauth login 加 --debug-out <path>。probe 提示 oauth_required 且目标是检查服务器表面时,继续 oauth login 获取凭证,再用 server info、server capabilities、tools list、resources list/read/templates、prompts list/get 检查已连接表面。需要广度快照时用 server doctor --out <path>。优先 --format json,需要请求与响应证据时加 --rpc。涉及 MCP 语义读 references/mcp-2025-11-25-interpretation.md,涉及 CLI 字段读 references/cli-surface-notes.md,安全审查读 references/security-best-practices.md。
适用场景:排查 MCP 服务器行为、解读 OAuth 发现与一致性结果、评估认证后暴露的 tools/resources/prompts、进行安全姿态评估与严重度定级。
限制:不得把 toolsMetadata 当作 MCP 服务器字段;无原始 RPC 证据不得从空 prompts 列表推断不支持 prompt;用户要求检查已认证表面时不得止步于 oauth_required;缺少 outputSchema 等可选元数据不算硬失败;--debug-out 是聚合证据包而非纯线级抓包;缺失 scopes_supported 或 WWW-Authenticate 中 scope 不算安全问题;仅凭拒绝某一次坏输入不能声称服务器安全;检查清单命中不单独构成 high。其余细节暂未提供。