展开本页目录
开始前准备什么
- 自己的 相关工具 环境与独立练习目录;现有配置先保留。
- 下载原创练习素材;需要模型的步骤沿用自己已验证的型号和凭据。
- 可选 Python 3,用于只读离线材料检查;通过不代表真实产品流程已运行。
- 选择已知只读服务并记录命令
- 启动 Inspector 连接 STDIO
- 先列工具并检查输入定义
- 提交一条合法参数
- 提交缺失和错误类型参数
- 检查协议日志与业务副作用
1. 选择已知只读服务并记录命令
本页使用 add 工具的 schema 教材;先准备自己已安装、理解权限的只读 MCP 服务。下载包不包含一个声称完整合规的服务器,不将未知 Github 命令直接当安全入口。
2. 启动 Inspector 连接 STDIO
按官方格式将服务启动命令传给 Inspector,在它输出的本地页面选择 STDIO 并 Connect。服务由 Inspector 启动,命令、参数和环境分别核对,教材不修改用户现有 MCP 设置。
3. 先列工具并检查输入定义
在 Tools 面板选择 List Tools,查看 add 的 a、b 均为必填 integer。工具 schema 描述的是输入契约,不能从工具名称就推断它只读。
config.json · 字段教材,不可作为工作流导入
{
"transport": "STDIO",
"command": "使用自己已安装的只读 MCP 服务启动命令",
"Inspector": "npx @modelcontextprotocol/inspector <server-command>",
"panel": "Tools → List Tools → 选择 add → 填写参数",
"log": "stdio 的 stdout 留给 JSON-RPC,日志写 stderr"
}4. 提交一条合法参数
发送 a=1、b=2,预期返回 3;保存请求与响应原文。工具直接运行的结果和某个聊天模型总结“已成功”是不同证据,先验收直接工具。
5. 提交缺失和错误类型参数
只填 a 以及 a=one 两种反例应拒绝。若服务自行转换类型或仍执行,记录实际行为并修正契约;本页 Python 检查只验收教材 schema,不运行 MCP。
6. 检查协议日志与业务副作用
STDIO 的 stdout 是 JSON-RPC 通道,调试日志用 stderr。完成后关闭本次 Inspector 与服务,核对没有写业务文件;真实工具是否只读须看服务实现和执行记录。
7. 下载教材并运行离线核对
先下载完整教材包并解压,在材料目录运行 python3 check-fixture.py。脚本只读取原创输入、人工预期与配置,对照本页固定验收条件;通过说明材料内部关系一致,实际产品、模型与业务写入另需按前六步验证。
bash
unzip lesson.zip -d mcp-inspector-tool-schema-test
cd mcp-inspector-tool-schema-test
python3 check-fixture.py怎样确认已经完成
- List Tools 的实际 schema 与必填字段一致。
- 合法参数返回 3,两种错误输入被拒绝。
- 日志不污染 stdout,验收不修改业务数据。
常见问题
Inspector 就是在聊天里调用 MCP 吗?
Inspector 直接连接服务并展示工具输入输出,适合排除模型与客户端配置因素;聊天客户端仍要单独验收完整调用。
本页提供 MCP 服务器吗?
没有。提供 schema、参数正反例和离线参数检查,自己准备已安装的只读服务;未声称 Inspector 或服务已运行。


