FlyPython
GitHub Start learning

可运行示例

MCP 工具服务（2026-07-28 规范）

构建符合 2026-07-28 无状态规范的 MCP 工具服务，实现无需 initialize 握手的 JSON-RPC 2.0 分发、参数校验、错误隔离与 input_required 多轮交互。

Intermediate15–20 minAI AgentPython 3.12+ · Standard library only · No API key

问题

Model Context Protocol 连接 AI 模型与外部工具及数据。朴素的服务端遇到未知工具会崩溃、跳过参数校验，而且仍然假设 2026-07-28 规范已移除的 initialize 握手。

任务契约

  1. 直接响应 tools/list 与 tools/call；2026-07-28 规范是无状态的，不存在 initialize 握手与会话。
  2. 按请求校验 _meta.protocolVersion，拒绝不支持的版本。
  3. 对非法请求、已移除或未知方法、非法参数返回 JSON-RPC 错误码 -32600、-32601 与 -32602。
  4. 执行前按声明的 inputSchema 校验必填工具参数。
  5. 把工具执行异常隔离为结构化的 isError 结果，而不是打断传输。
  6. 完成 input_required 多轮交互：返回待回答请求，客户端携带 params.inputResponses 重试后完成。

本地验证

在 FlyPython 仓库根目录下，先复现 starter 的失败，再验证审校过的 solution：

python examples/mcp-server/verify.py starter --expect-failure
python examples/mcp-server/verify.py solution

交给 coding agent

  1. 克隆仓库，用上面的命令复现 starter 失败。
  2. 把任务契约 ↗交给你的 coding agent，只允许修改 starter/mcp_server.py。
  3. 运行 python examples/mcp-server/verify.py starter，任何失败都视为未完成。
  4. 与参考实现 ↗对比补丁——目标是同样的契约配最小可读的 diff，而不是相同的语法。

继续

这个示例在学习路线中的位置。

审校日期 2026-09-06 · 仓库内容版本 2。可以继续阅读对应学习路径、浏览仓库目录，或阅读 MCP 迁移指南了解规范背景。

查看中文指南集合 →浏览仓库目录 ↗MCP 2026-07-28 迁移指南（中文） →