罗罗编程学习记录
本页内容 展开查看

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 的测试用例并断言错误路径