FastMCP

它做什么

• 装饰器驱动：@mcp.tool / @mcp.resource / @mcp.prompt —— Python 函数即 server 原语
• 类型注解生成 schema：JSON Schema 从 Python 类型注解自动生成，支持 Pydantic 模型
• 传输层：stdio（本地客户端：Claude Code、Inspector）、HTTP / Streamable HTTP（远程）
• 内置辅助：image / audio / PDF content、sampling、elicitation、结构化 prompt
• Server 组合：把一个 FastMCP server 挂载 / 导入到另一个；auth providers（Google、GitHub、Azure）

什么时候用

最适合「一个下午上线一个 MCP server」的场景——把现有内部 API 包成 MCP、把数据库暴露成可查询的 resource、给 Agent SDK 项目提供自定义工具侧。Python 生态的事实标准；配 uv 启动很快。

如何上手

uv add fastmcp

然后：

from fastmcp import FastMCP
mcp = FastMCP("my-server")
@mcp.tool
def add(a: int, b: int) -> int: return a + b
mcp.run()

stdio 用 python -m my_server 跑；HTTP 用 transport="http" 跑 Streamable HTTP server。

注意事项

FastMCP 有自己的 major 版本节奏（当前 v2.x）——生产请 pin。async-first API 与 uvicorn 风格事件循环最配；支持 sync 工具函数但框架鼓励 async def。