在线开发台:在浏览器里调试 MCP Server
用本站内置的「MCP 在线开发台」实战:连接 Server、发现工具、填参调用——像 Postman 一样调试 MCP。
为什么需要一个调试台
开发 MCP Server 时最常问的问题是:"我的工具在模型眼里长什么样?调用时会发生什么?" 本站内置的「MCP 在线开发台」(导航栏直达)就是回答这个问题的 Postman:
- 连接任意 stdio(本地子进程) 或 HTTP/SSE(远程) 的 MCP Server;
- 自动执行协议握手并
tools/list,列出工具名、描述与 inputSchema —— 这正是模型看到的"工具说明书"; - 按 schema 填 JSON 参数、点「调用」,直接看到工具的真实返回 —— 无需先接进 Claude Desktop 或 Agent。
推荐调试工作流
- 先看描述:连接后逐条读工具描述 —— 想象自己是模型:这个描述能让我判断"什么时候该用它"吗?模糊就回去改 docstring;
- 再验 schema:参数名、类型、必填项是否清晰?给每个参数写好 description;
- 打真实调用:用正常值、边界值(空串、超长)、错误值各调一遍,观察返回是优雅报错还是抛异常;
- 过安全清单:对照《MCP 安全与生产实践》逐条自查后才接入正式 Agent。
立即上手
打开「代码沙箱」旁的 MCP 开发台,选 stdio 模式,命令填 python、参数填你写好的 server 脚本路径(参考上一课的 FastMCP 示例),点连接 —— 你的 Server 已经在网页里跑起来了。
调试台与课程配合的意义:协议知识(86-87 课)+ 动手实现(88 课)+ 可视化调试(本课)= 完整的 MCP 开发闭环。
📝 课后练习
quiz-1 用 MCP 调试台连接 Server 后,首先应该检查什么?