FastMCP 2.x 快速入门教程

如果你已经在用大模型做应用，多半遇到过同一个尴尬：模型本身很聪明，但要让它去读你本地的文件、查你内部的数据库、调一段只有你才有的业务接口，就得自己写一层"胶水"。MCP（Model Context Protocol）想解决的就是这层胶水，而 FastMCP 是把这个协议从"要读规范"降到"会写 Python 装饰器"的那一层封装。这门《FastMCP 2.x 快速入门教程》针对的，正是这段从零散脚本到可部署服务的路。它不负责把你变成协议专家，而是让你在最短时间内跑起来一个能被客户端识别的 MCP 服务。

先确认你缺的是哪一块

MCP 生态里常见三类缺口，对照一下自己属于哪种，再决定看多深：

• 协议听说过，代码没写过。知道 MCP 是干什么的，但 tool、resource、prompt 这三类原语分别对应什么使用场景，脑子里是糊的。这类读者重点看基础概念那部分，搞清楚什么该做成工具、什么该做成资源，别一上来就把所有东西都塞成 tool。
• 会写单机脚本，不会接入客户端。本地跑通一个函数没问题，但传输方式（stdio 还是 HTTP）、客户端怎么发现你的服务、参数 schema 怎么自动生成，这些接线环节没碰过。这部分是 FastMCP 最省事的地方，也是课程的核心操作段。
• 本地能跑，部署没谱。服务在自己电脑上好好的，一到要给别人用、要长期在线，就卡在托管、鉴权、地址配置上。课程后半段涉及部署到 FastMCP Cloud，解决的就是这个断点。

如果你已经能熟练手写 MCP 服务端并自建过部署流程，这门课的增量有限，可以跳过。它面向的是还没走完第一遍的人。

这门课真正要你动手的部分

FastMCP 的卖点是用装饰器把 Python 函数暴露成 MCP 能力，所以课程里大部分时间应该花在"改一行、看一次效果"上，而不是背 API。建议带着具体目标去练：拿一个你平时重复手工做的操作——比如读某个目录下的日志、查一张表、拼一段固定格式的请求——把它包装成一个 tool，然后用客户端实际调一次。走通这一遍，比看完十段讲解有用。

resource 和 prompt 这两类容易被忽略，但恰是区分"能用"和"好用"的地方。静态数据、只读内容更适合做 resource；需要引导模型按固定套路输出的，考虑 prompt。练习时不妨同一个需求用两种方式各写一遍，体会差别，你会对协议设计的意图清楚很多。

看完应该能回答的问题

• 一个 MCP 服务从代码到被客户端调用，中间经过哪几步？传输方式的选择会带来什么差别？
• 同一个需求，什么时候做成 tool，什么时候做成 resource 或 prompt？
• 函数的类型标注和文档字符串在 FastMCP 里起了什么作用，如果不写会怎样？
• 本地调试和部署到云端，配置上有哪些必须改动的地方？
• 服务上线后，怎么确认它真的被客户端正确识别，而不是"看起来跑了"？

能答上这五个问题，说明你不是照着敲了一遍，而是理解了这条链路。

怎么用这份资料

按顺序过一遍基础概念即可，不必反复看，概念部分看第二遍的收益远低于动手一遍。真正的重点在服务定义和部署两段，遇到卡壳就回到对应小节。学完建议留一份笔记，但别写成 API 抄录——记录你踩过的坑更有价值：某个参数为什么必须这么传、客户端为什么没认到你的服务、部署后地址为什么连不上，这些才是下次能直接复用的东西。