FastMCP 2.x 快速入门教程

这门课讲的是 FastMCP 2.x，一个用来写 MCP 服务端程序的 Python 框架。如果你最近总听到「MCP」这个词，但还没弄明白它到底解决什么问题，这门课可以当作你的第一站。不过先说清楚：它不是给完全没写过 Python 的人准备的。你至少要能读懂函数、装饰器、类型标注这几样东西，否则前几讲就会卡住。

先弄明白 MCP 是什么，再动手写

课程开头没有直接让你敲代码，而是先讲清楚 MCP 的定位：它是一套让模型和外部工具、数据源对话的协议。这部分建议你放慢速度看，不要跳过。很多人后面写代码时反复出错，根源不在语法，而在于没想明白「我写的这个函数，是给谁调的、通过什么方式暴露出去」。把这层关系理顺了，后面的代码其实很短。

如果你已经用过别的协议或插件机制，这段可以快进，但建议至少把示例里那个最小的工具函数跑通一遍。跑通一次，比看十遍概念有用。

中间几讲是主干，别贪快

从定义工具、接参数，到返回结构化结果，这几讲是整门课的核心。这里的节奏建议是：一讲看完，自己改一个参数、换一个返回值，确认行为符合预期，再往下走。FastMCP 的写法很简洁，正因为简洁，写错了往往不报错、只是行为不对，所以动手验证比看懂更重要。

资源（resource）和提示（prompt）那部分，如果你只是想先做出一个能用的工具服务，第一遍可以只浏览，知道有这回事就行。等你的项目真的需要把文件、数据库记录暴露给模型时，再回头细看，那时理解会快得多。

部署那一讲，看你的实际需求

课程后段会讲到把它部署到 FastMCP Cloud 上。这一讲的价值在于让你看到「本地能跑」和「别人能用」之间差了什么：网络可达、鉴权、环境变量、日志。如果你只是自己在本机做实验，这部分可以先跳过，不影响你前面的学习。但如果你打算把做好的东西分享给同事或接到别的应用里，那就值得认真走一遍流程。

• 先跑通最小示例，再谈理解框架设计
• 工具定义部分反复练，资源和提示部分可按需延后
• 不打算共享服务的话，部署一讲可以暂时略过
• 每讲之间留一天消化，比一口气刷完更稳

资料怎么配合练习

配套的章节笔记适合在动手前扫一眼、动手后对照检查，但不建议当成教材从头读到尾。真正要吃透，还是得自己写一个跟课程示例不同的小工具，哪怕只是查天气、读本地文件这种。写的过程中你会遇到课程里没提到的问题，那些问题才是你真正学到的东西。

最后说句实在话：这门课体量不大，快的话两三天能过一遍，但「过一遍」和「会写」是两回事。如果你时间碎，就按每个小节能独立跑通为准，不必追求进度。学不完的部分，放一放，等有具体需求时再回来补，反而更容易记住。