04.7.18 FastMCP 服务端框架
所属:全栈开发面试题库 / 04 后端语言与运行时 / 04.7 Python
覆盖范围
- MCP 协议模型:JSON-RPC 2.0、client/server/host 与能力协商
- 服务端三原语:tools、resources、prompts
FastMCP实例、服务端生命周期与lifespan- 工具/资源/提示注册与 JSON Schema 生成
- stdio / SSE / Streamable HTTP 传输与鉴权
- 部署、测试、可观测性与安全边界
题量统计
- 主题页 3 个,合计 180 题。
- 每题按「一句话结论 → 概念解释 → 原理流程 → 代码或图示 → 常见误区 → 追问(带内联答案)」六段式组织。
- 版本基线:FastMCP 2.x、MCP 规范 2025 版;API 名与默认值不确定处统一标注「待确认」并给出验证点。
- 边界:本章只写 MCP 服务端框架本身,不涉及模型调用、RAG 与 Agent 编排(相关内容属于第 10 分册)。
子页面
| 编号 | 页面 | 题量 | 覆盖要点 |
|---|---|---|---|
| 04.7.18.1 | MCP 协议模型与 Server 核心 | 60 | JSON-RPC 报文、能力协商、三原语语义、通知与进度、三种传输差异、Server 构造与能力声明、lifespan、与 FastAPI/Starlette 集成、错误码分层 |
| 04.7.18.2 | 工具、资源、提示与 Schema | 60 | @mcp.tool 与签名到 schema 的映射、docstring 与 Field 描述、Context 注入、返回内容块、Pydantic 模型入参、URI 模板资源、提示模板、动态注册、超时与取消 |
| 04.7.18.3 | 传输、鉴权、生命周期与部署测试 | 60 | stdio 输出纪律、SSE 与 Streamable HTTP 端点、会话隔离、OAuth 资源服务器与 token 校验、反代与 CORS、容器与多副本、可观测性、内存内 client 测试、安全与故障排查 |
学习路径
协议与 Server 核心(04.7.18.1)
→ 注册与 Schema(04.7.18.2)
→ 传输、鉴权与部署(04.7.18.3)
先确认「服务端只暴露能力,不决定谁来调用」,再理解类型注解如何变成 schema,最后讨论传输与鉴权这类工程问题。协议细节若与当前规范冲突,以官方规范为准并标注版本。
自检清单
- [ ] 能说明 MCP 的 client/server/host 分工与
initialize协商内容 - [ ] 能区分 tools、resources、prompts 的适用边界与报文形态
- [ ] 能解释函数签名如何映射成 JSON Schema,以及 docstring 的作用
- [ ] 能说明 stdio 传输下为什么禁止向 stdout 打印日志
- [ ] 能给出一个带 Bearer 鉴权与健康检查的服务端部署方案
- [ ] 能写出内存内 client 的测试用例并断言错误路径