FastMCP 是一个专为大模型服务的 Python 框架,它通过声明式语法和 MCP 协议,让开发者能以十倍效率构建 AI 应用。本教程将带你从零到一,全面掌握 FastMCP 的核心概念、模块用法和实战技巧。
一、FastMCP 的技术哲学
1.1 MCP 协议:大模型时代的“新 HTTP”
Model Context Protocol(MCP) 是专为 LLM 设计的交互协议,正在成为连接 AI 模型与业务系统的“新基建”。与传统 API 不同,MCP 通过三大核心组件构建对话式交互:
- 资源(Resources):动态数据注入(类比 GET)
- 工具(Tools):功能执行接口(类比 POST)
- 提示(Prompts):交互范式模板
1.2 Pythonic 革命的终极形态
FastMCP 以“Python 之禅”为设计核心,用装饰器语法实现协议抽象:
1from fastmcp import FastMCP
2mcp = FastMCP("智能客服系统")
3
4@mcp.tool()
5def query_order(order_id: str) -> str:
6 """查询订单状态"""
7 return db.execute(f"SELECT status FROM orders WHERE id={order_id}")
8
9@mcp.resource("user_profile://{user_id}")
10def get_profile(user_id: str):
11 """获取用户画像"""
12 return json.dumps(user_profiles[user_id])
技术亮点:
- 声明式开发:功能即装饰
- 类型安全:Pydantic 深度集成
- 异步优先:原生支持协程
