# MCP Inspector 教程

原创虚构输入与人工预期输出。未运行产品实例、未调用模型、未外发或发布。config.json 为字段教材，不是可导入 n8n/Dify/Flowise/Langflow 工作流。

## 1. 选择已知只读服务并记录命令
本页使用 add 工具的 schema 教材；先准备自己已安装、理解权限的只读 MCP 服务。下载包不包含一个声称完整合规的服务器，不将未知 Github 命令直接当安全入口。

## 2. 启动 Inspector 连接 STDIO
按官方格式将服务启动命令传给 Inspector，在它输出的本地页面选择 STDIO 并 Connect。服务由 Inspector 启动，命令、参数和环境分别核对，教材不修改用户现有 MCP 设置。

## 3. 先列工具并检查输入定义
在 Tools 面板选择 List Tools，查看 add 的 a、b 均为必填 integer。工具 schema 描述的是输入契约，不能从工具名称就推断它只读。

## 4. 提交一条合法参数
发送 a=1、b=2，预期返回 3；保存请求与响应原文。工具直接运行的结果和某个聊天模型总结“已成功”是不同证据，先验收直接工具。

## 5. 提交缺失和错误类型参数
只填 a 以及 a=one 两种反例应拒绝。若服务自行转换类型或仍执行，记录实际行为并修正契约；本页 Python 检查只验收教材 schema，不运行 MCP。

## 6. 检查协议日志与业务副作用
STDIO 的 stdout 是 JSON-RPC 通道，调试日志用 stderr。完成后关闭本次 Inspector 与服务，核对没有写业务文件；真实工具是否只读须看服务实现和执行记录。

## 离线验收
运行 python3 check-fixture.py，仅检查固定输入与人工预期关系，不验证真实模型、产品节点或工作流执行。

## 官方来源
- [MCP 官方：Inspector 工具参数调试](https://modelcontextprotocol.io/docs/2026-07-28/tools/inspector)