FastMCP 更名为 MCPServer:把 Python MCP 服务迁到 MCP SDK 2.x
来源:dev.to — 2026-09-11
📋 概述
仓库里的代码一行没改,一次全新安装就把它打挂了:requirements.txt 里的 mcp 没有版本上限,于是解析到 2.x,原来的导入路径直接报 ModuleNotFoundError。2.x 中 FastMCP 已改名为 MCPServer,但包里仍保留一个同名模块,唯一作用就是抛出这条带解释的报错——比干巴巴的一句「没有这个模块」友好得多。在 Claude Code 里,这个故障只会显示为连接关闭,因为进程在手握前就死了。作者对比了钉版本与迁移两条路各自的代价,并给出了把 Gemma 4 的 vLLM 后端重新部署到 Cloud Run L4 GPU 的完整步骤。
🔑 核心要点
- 根因是 requirements.txt 未设版本上限,新装直接解析到 mcp 2.x。
- 2.x 中 FastMCP 更名为 MCPServer,导入路径同步改变。
- 在客户端里故障只显示为 Connection closed,因为 stdio 在握手前就关闭了。
- 钉版本要在每个解释器上做,迁移只改仓库,两者代价不同。
💡 金句
Nothing in the repository changed. A fresh install did.
👍 0
👎 0
← 返回 dev.to 首页