FastMCP教程：27.9k星快速构建MCP服务器，Pythonic方式定义工具和资源

📌 项目：PrefectHQ/fastmcp | 星数：27.9k（2026-09-25） | 协议：Apache-2.0 | 语言：Python | GitHub

一句话定位："用Python装饰器定义MCP工具——FastMCP让构建MCP服务器像写Flask一样简单。" FastMCP是Prefect团队出品的MCP框架，用装饰器语法声明工具、资源和提示词，自动处理MCP协议细节，几分钟就能搭好一个MCP服务器。

⚡ 核心设计：装饰器即工具

FastMCP的核心是装饰器语法，把普通Python函数变成MCP工具：

from fastmcp import FastMCP

mcp = FastMCP("My Server")

@mcp.tool()
def calculate(a: float, b: float, operation: str) -> str:
    """计算两个数的运算结果"""
    if operation == "add":
        return str(a + b)
    return "unknown operation"

@mcp.resource("file://{path}")
def read_file(path: str) -> str:
    """读取文件内容"""
    with open(path) as f:
        return f.read()

@mcp.prompt()
def code_review(code: str) -> str:
    """生成代码审查提示"""
    return f"请审查以下代码:\n{code}"

FastMCP自动从类型注解生成MCP schema，AI助手能看到参数类型和描述。和 Chrome DevTools MCP 桥接已有工具不同，FastMCP是构建自定义MCP服务器的框架。

🚀 快速开始

pip install fastmcp

# server.py
from fastmcp import FastMCP
mcp = FastMCP("My First Server")

@mcp.tool()
def greet(name: str) -> str:
    """问候"""
    return f"Hello, {name}!"

if __name__ == "__main__":
    mcp.run()  # 默认stdio传输

支持两种传输模式：mcp.run(transport="stdio")用于本地集成，mcp.run(transport="sse", port=8000)用于远程访问。

🔧 高级特性

• Context对象：工具可接收Context获取请求ID、进度报告、日志
• 异步支持：async def工具自动支持
• 资源模板：URI模板如file://{path}自动解析参数
• 客户端：FastMCP也提供客户端连接其他MCP服务器
• 组合服务器：多个MCP服务器可组合为一个对外服务

⚖️ 优缺点