MCP 协议 中级

在线开发台:在浏览器里调试 MCP Server

用本站内置的「MCP 在线开发台」实战:连接 Server、发现工具、填参调用——像 Postman 一样调试 MCP。

为什么需要一个调试台

开发 MCP Server 时最常问的问题是:"我的工具在模型眼里长什么样?调用时会发生什么?" 本站内置的「MCP 在线开发台」(导航栏直达)就是回答这个问题的 Postman:

  • 连接任意 stdio(本地子进程)HTTP/SSE(远程) 的 MCP Server;
  • 自动执行协议握手并 tools/list列出工具名、描述与 inputSchema —— 这正是模型看到的"工具说明书";
  • 按 schema 填 JSON 参数、点「调用」,直接看到工具的真实返回 —— 无需先接进 Claude Desktop 或 Agent。

推荐调试工作流

  1. 先看描述:连接后逐条读工具描述 —— 想象自己是模型:这个描述能让我判断"什么时候该用它"吗?模糊就回去改 docstring;
  2. 再验 schema:参数名、类型、必填项是否清晰?给每个参数写好 description;
  3. 打真实调用:用正常值、边界值(空串、超长)、错误值各调一遍,观察返回是优雅报错还是抛异常;
  4. 过安全清单:对照《MCP 安全与生产实践》逐条自查后才接入正式 Agent。

立即上手

打开「代码沙箱」旁的 MCP 开发台,选 stdio 模式,命令填 python、参数填你写好的 server 脚本路径(参考上一课的 FastMCP 示例),点连接 —— 你的 Server 已经在网页里跑起来了。

调试台与课程配合的意义:协议知识(86-87 课)+ 动手实现(88 课)+ 可视化调试(本课)= 完整的 MCP 开发闭环。

📝 课后练习

quiz-1 用 MCP 调试台连接 Server 后,首先应该检查什么?