FlyPython
Sign inStart a challenge

用 MCP 给你的 Agent 装上工具（Python） · 第 03 题 · English

校验与错误隔离

检查点 l0310 分测试套件判定Claude Code 2.x（协议：MCP 2026-07-28）

参数是不可信输入：先校验再执行，绝不让处理函数打断传输。

在用 Agent 做题？一句话开始整门课程：

Read https://flypython.com/skills/flypython/SKILL.md and start the FlyPython course `mcp-server-in-python`.

校验与错误隔离

目标

参数是不可信输入：先校验再执行，绝不让处理函数打断传输。

课程内容

两条边界让工具服务变得安全：按声明的 inputSchema 校验必填参数（缺参变成结构化结果而不是异常），并包裹每个处理函数，让它的失败返回 isError 而不是断开连接。03-missing-argument.json 在线路上演示了第一条边界。

练习

  • 把每个校验测试对应到它锚定的契约行
  • 问：如果处理函数抛出 InputRequired 会怎样？（下一课。）

检查点

本课的命令运行通过，并且你能用自己的话回答下面的问题（由 Agent 提问、你作答——这就是关口）：

  1. 本课跑了哪条命令，它判定了什么？
  2. 一开始什么失败了、为什么——用你自己的话说？
  3. 下次再信任类似的改动之前，你会先检查什么？

预期证据

命令输出记录与你的回答。

提示

卡住了？逐条打开。

提示 1 —— 这个检查点考什么

python verify.py starter——实现 MCPServer 的 register_tool 与 handle_request：校验、分发、错误隔离全绿。

提示 2 —— 工具是不可信输入

缺必填参数 → isError 内容 'Missing required argument: <arg>'；未知工具 → 'Tool not found'；处理函数抛异常 → isError 'Error: <e>'。工具失败绝不能打断传输层。

提示 3 —— 返回形态

tools/list 产出带 name/description/inputSchema 的 result.tools；tools/call 产出 text 型 result.content——信封结构要精确，套件比对的是结构。

提交

做完了？记录它。

提交 verify.py progress 为本检查点打印的 8 位认领码——浏览器里交，或让你的 Agent 直接交。

你浏览器

提交认领码

你的 Agent自动提交

让 Agent 解题并自动提交

把这题交给它（悬停出现复制按钮）——解题、验证、提交全程自动：

请完成 FlyPython 挑战课程「用 MCP 给你的 Agent 装上工具（Python）」（course id course-mcp-tools）的检查点 l03。
机读简报：https://flypython.com/api/challenges/mcp-server-in-python
打开课程文件夹，先读 TASK.md——它就是契约。
规则：最小变更、不新增依赖、绝不修改 tests/ 或 solution/。
用 python verify.py 检查直到门控通过，把每个认领码告诉我。
目标：只做检查点 l03 这一道题，完成后立即提交。

用你Agent 页生成的令牌（环境变量 FLYPYTHON_TOKEN），它可以直接记录结果：

curl -X POST https://flypython.com/api/claims \
  -H "Authorization: Bearer $FLYPYTHON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"claims":[{"course":"mcp-server-in-python","checkpoint":"l03","code":"<8-char code>"}]}'

或一次性安装完整的 FlyPython Agent Skill，连粘贴都省了。

文件

starter 与验证器

解题在你的机器上运行——Agent 通过 /api/challenges/mcp-server-in-python/files 自己取回课程文件，你无需手动下载。想直接读源码？在 GitHub 上查看文件夹 ↗