73_FastMCP 2.x 干货笔记之参与 FastMCP 开发：版本完整更新日志

更多相关视频教程： 👉 《FastMCP快速入门教程》

更多相关文章内容： 👉 《FastMCP 2.x 干货笔记》专栏

v2.13.0 – 2025年10月25日

版本标题：缓存优化升级

FastMCP 2.13 “缓存优化升级” 标志着该框架的成熟化发展。经过数月关于认证和状态管理的社区反馈，此版本提供了 FastMCP 处理生产工作负载所需的基础设施：持久化存储、响应缓存以及反映实际部署挑战的实用 OAuth 改进。

新特性

💾 可插拔存储后端

为 FastMCP 服务器带来持久化状态支持

基于 FastMCP 维护者 Bill Easton 开发的新库 py-key-value-aio

存储层默认提供加密磁盘存储、平台感知的令牌管理和简单的应用状态键值接口

支持为 Elasticsearch、Redis、DynamoDB、文件系统、内存等后端添加加密、TTL、缓存等功能的封装

OAuth 提供商现在可自动在重启间持久化令牌

开发者无需外部数据库即可存储任意状态

🔐 OAuth 成熟化

集成数月的生产环境经验教训

新的同意屏幕防止早期版本中发现的混淆代理和授权绕过攻击

提供具有可定制品牌的清晰用户体验

OAuth 代理现在使用自动从客户端密钥派生的密钥签发自己的令牌

支持 RFC 7662 令牌内省，实现企业认证流程

路径前缀挂载使受 OAuth 保护的服务器能够集成到现有 Web 应用程序中

符合 MCP 1.17+ 和 RFC 9728 确保协议兼容性

⚡ 响应缓存中间件

显著提高昂贵操作的性能

使用可配置的 TTL 缓存工具和资源响应

减少冗余 API 调用并加速重复查询

🔄 服务器生命周期

提供适当的初始化和清理钩子，每个服务器实例运行一次而不是每个客户端会话

修复了 MCP SDK 中长期存在的混淆源

为数据库连接、后台任务和其他服务器级状态启用适当的资源管理

✨ 开发者体验改进

Pydantic 输入验证以提高类型安全性

图标支持以丰富用户体验

RFC 6570 资源模板查询参数

改进的 Context API 方法（list_resources、list_prompts、get_prompt）

异步文件/目录资源

此版本包含 20 位新贡献者的提交，代表了近期最大的功能集。

完整更新日志： v2.12.5…v2.13.0

v2.12.5 – 2025年10月17日

版本标题：安全锁定

FastMCP 2.12.5 是一个点发布版本，将 MCP SDK 版本锁定在 1.17 以下，该版本引入了一个影响在大型应用程序中挂载认证提供程序的 FastMCP 用户的变更。这确保了在使用 FastMCP 认证提供程序与复合应用程序时，.well-known 负载出现在预期位置。

修复

将 MCP SDK 版本锁定在 1.17 以下

完整更新日志： v2.12.4…v2.12.5

v2.12.4 – 2025年9月26日

版本标题：OIDC 增强支持

FastMCP 2.12.4 添加了全面的 OIDC 支持，并通过 AWS Cognito 和 Descope 提供程序扩展了认证选项。此版本还包括对日志中间件、嵌套资源 URL 处理、持久化 OAuth 客户端注册存储的改进，以及对实验性 OpenAPI 解析器的各种修复。

新特性

添加 OIDC 配置支持

主要改进

扩展认证选项，新增 AWS Cognito 和 Descope 提供程序

改进日志中间件和嵌套资源 URL 处理

添加持久化 OAuth 客户端注册存储

修复实验性 OpenAPI 解析器的多个问题

完整更新日志： v2.12.3…v2.12.4

v2.12.3 – 2025年9月17日

版本标题：性能加倍

FastMCP 2.12.3 专注于基于社区反馈的性能和开发者体验改进。此版本包括减少服务器启动时间的优化认证提供程序导入、具有适当令牌管理的增强 OIDC 认证流程，以及 OAuth 代理配置的几个可靠性修复。自动内联快照创建的添加显著改善了贡献者的测试体验。

新特性

支持通过传输配置设置 MCP 日志级别

主要改进

优化认证提供程序导入，减少服务器启动时间

增强 OIDC 认证流程，改进令牌管理

添加自动内联快照创建，改善测试体验

完整更新日志： v2.12.2…v2.12.3

v2.12.2 – 2025年9月3日

版本标题：流传输修复

这是一个针对 streamable-http 传输在 fastmcp.json 配置文件中未被识别为有效选项的错误的紧急修复，尽管 CLI 支持该传输。这导致 CLI 参数与配置规范合并时出现解析错误。

修复

修复 fastmcp.json 配置中 streamable-http 传输的验证问题

完整更新日志： v2.12.1…v2.12.2

v2.12.1 – 2025年9月3日

版本标题：OAuth 完善

FastMCP 2.12.1 基于广泛的社区测试和反馈加强了 OAuth 代理实现。此版本改进了客户端存储可靠性，添加了 PKCE 转发以增强安全性，引入了可配置的令牌端点认证方法，并扩展了范围处理 – 所有这些都解决了自 2.12.0 以来发现的实际集成挑战。具有模拟提供程序的增强测试套件确保这些改进是健壮且可维护的。

破坏性变更

OAuth 代理：内置 IDP 集成的用户应注意，为清晰和一致性，resource_server_url 已重命名为 base_url

主要改进

改进客户端存储可靠性

添加 PKCE 转发增强安全性

引入可配置的令牌端点认证方法

扩展范围处理能力

完整更新日志： v2.12.0…v2.12.1

v2.12.0 – 2025年8月31日

版本标题：认证体系完善

FastMCP 2.12 代表了迄今为止最重要的版本之一，无论是在范围还是社区参与度方面。经过与社区的广泛测试和迭代，我们发布了认证、配置和 MCP 功能采用方面的重大改进。

主要特性

🔐 更广泛的提供程序 OAuth 代理支持

解决基本挑战：虽然 MCP 需要动态客户端注册（DCR），但许多流行的 OAuth 提供程序不支持它

新的 OAuth 代理弥合了这一差距，使 FastMCP 服务器能够通过最小配置与 GitHub、Google、WorkOS 和 Azure 等提供程序进行认证

这些原生集成今天发布，计划根据社区需求添加更多提供程序

📋 声明式 JSON 配置

引入标准化、可移植的方式来描述和部署 MCP 服务器

fastmcp.json 配置文件成为依赖项、传输设置、入口点和服务器元数据的单一事实来源

为未来的转换和远程源功能奠定基础

🧠 采样 API 回退

解决限制高级 MCP 功能采用的先有鸡还是先有蛋的问题

采样功能强大但由于有限的客户端支持而未得到充分利用

FastMCP 现在允许服务器作者定义回退处理程序，在客户端不支持该功能时在服务器端生成采样完成

此版本花费了比平常更长的时间来发布，原因很充分：社区对认证系统的积极测试和反馈帮助我们达到了我们确信的稳定性水平。

完整更新日志： v2.11.3…v2.12.0

v2.11.3 – 2025年8月11日

版本标题：API 优化变更

此版本包含对实验性 OpenAPI 解析器的显著增强，并修复了一个重要错误，该错误导致如果模式是传递依赖项（例如 A → B → C 意味着 A 依赖于 C），则不会在输入/输出模式中包含模式。对于将大型 OpenAPI 规范转换为 MCP 服务器的用户，这可能导致负载大小膨胀并需要管理。

主要改进

优化 OpenAPI 负载大小减少 46%

改进重定向处理以支持 307 状态码

导入/挂载时确保资源和模板名称正确添加前缀

修复

修复 OpenAPI 传递引用和性能问题

确保转换后的工具生成结构化内容

修复 OpenAPI allOf 处理在请求体顶层的问题

完整更新日志： v2.11.2…v2.11.3

v2.11.2 – 2025年8月6日

版本标题：工厂函数支持

主要改进

在 fastmcp run 中支持工厂函数

在 FastMCPProxy 中添加 client_factory 的异步支持

修复

修复检查清单中的 server_version 字段

修复同时具有 default 和 default_factory 的 Settings 字段

完整更新日志： v2.11.1…v2.11.2

v2.11.1 – 2025年8月4日

版本标题：认证增强

新特性

引入 RemoteAuthProvider 用于更清晰的外部身份提供商集成

主要改进

优化 OpenAPI 参数字符串操作性能

更新认证文档

修复

修复方法绑定 FunctionTool 模式

修复 model_copy() 后手动设置 _key 以支持前缀转换工具

完整更新日志： v2.11.0…v2.11.1

v2.11.0 – 2025年8月1日

版本标题：认证体系启动

FastMCP 2.11 加倍投入开发者最需要的功能：速度和简单性。这个大规模版本提供了显著的性能改进和明显更好的开发者体验。

主要特性

🔐 企业级认证

通过 WorkOS 的 AuthKit 集成带来全面的 OAuth 2.1 支持

新的 AuthProvider 接口利用 MCP 对独立资源和授权服务器的支持

处理 API 密钥和具有动态客户端注册的远程认证

AuthKit 集成意味着您可以插入现有的企业身份系统而无需重建认证堆栈

⚡ 实验性 OpenAPI 解析器

通过单次模式处理和优化内存使用提供显著的性能改进

OpenAPI 集成现在显著更快，具有更清晰、更可维护的代码

注意：实验性解析器默认禁用，设置 FASTMCPEXPERIMENTALENABLENEWOPENAPIPARSER=1 来启用它

🧠 上下文状态管理

通过简单的字典接口在工具调用之间提供持久状态

增强的元支持让您向客户端暴露丰富的组件元数据

改进的类型注解、基于字符串的参数描述和 UV 传输支持

完整更新日志： v2.10.6…v2.11.0

v2.10.6 – 2025年7月19日

版本标题：周末修复

一个特殊的周六发布版本，包含许多修复。

主要改进

在 Context.sample 中实现 include_context 参数

添加日志级别标准化

为挂载的服务器警告添加服务器名称

添加 StatefulProxyClient

修复

修复 OpenAPI 空参数

修复工具转换中的标题字段保留

修复 OpenAPI 集成中的可选参数验证

修复工具输出模式生成以尊重 Pydantic 序列化别名

完整更新日志： v2.10.5…v2.10.6

v2.10.5 – 2025年7月11日

版本标题：中间件管理

专注于 OpenAPI 改进和中间件修复的维护版本，外加控制台改进。

主要改进

修复 Claude Code CLI 检测以支持 npm 全局安装

通过位置后缀修复 OpenAPI 参数名称冲突

为代理服务器添加镜像组件支持

修复

修复 OpenAPI deepObject 样式参数编码

在 OpenAPI 输出模式中将 oneOf 替换为 anyOf

修复中间件列表结果类型

完整更新日志： v2.10.4…v2.10.5

v2.10.4 – 2025年7月9日

版本标题：传输修复

快速修复以确保 CLI 接受 “streamable-http” 作为有效的传输选项。

修复

确保 CLI 接受 “streamable-http” 作为有效传输

完整更新日志： v2.10.3…v2.10.4

v2.10.3 – 2025年7月9日

版本标题：CLI 全面改进

主要的 CLI 大修，包括从 typer 到 cyclopts 的完全重构、新的 IDE 集成和全面的 OpenAPI 改进。

新特性

将 CLI 从 typer 重构为 cyclopts 并添加全面测试

为 OpenAPI 工具添加输出模式支持

主要改进

通过 CLI 集成添加 Cursor 支持

添加 Claude Code 安装集成

从 CLI 生成 MCP JSON 配置输出作为新的 fastmcp install 命令

为 HTTP/SSE 路由添加 –path 选项

完整更新日志： v2.10.2…v2.10.3

v2.10.2 – 2025年7月5日

版本标题：高级功能转发

此版本的主要特性是能够通过代理服务器”转发”高级 MCP 交互，如日志记录、进度和引导。如果远程服务器请求引导，代理客户端将把该请求传递给新的”最终”客户端。

新特性

代理支持高级 MCP 功能

主要改进

重新添加启动画面

在 MCPConfig 中允许每个服务器超时

在 BearerAuthProvider 中支持 ‘scp’ 声明用于 OAuth 范围

为图像/音频/文件添加路径扩展

完整更新日志： v2.10.1…v2.10.2

v2.10.1 – 2025年7月2日

版本标题：撤销 CLI 横幅

快速修补以撤销在 v2.10.0 中添加的 CLI 横幅。

文档

撤销”添加 CLI 横幅”

完整更新日志： v2.10.0…v2.10.1

v2.10.0 – 2024年7月1日

版本标题：规范期望

FastMCP 2.10 带来了与 2025年6月18日 MCP 规范更新的完全兼容性，引入了用于动态服务器-客户端通信的引导支持和用于结构化工具响应的输出模式。请注意，由于这些更改，此版本还包括对 client.call_tool() 返回签名的破坏性变更。

引导支持

引导允许 MCP 服务器在工具执行期间向客户端请求额外信息，实现更具交互性和动态的服务器行为。这为在执行期间需要用户输入或确认的工具开辟了新的可能性。

输出模式

工具现在可以定义结构化输出模式，确保响应符合预期格式，使工具集成更可预测和类型安全。

破坏性变更

由于 MCP 规范更新，升级到 mcp 1.10

client.call_tool() 的返回签名发生变更

完整更新日志： v2.9.2…v2.10.0

v2.9.2 – 2024年6月26日

版本标题：安全锁定

这是一个修补程序版本，将 mcp 锁定在 1.10 以下，该版本包含与 2025年6月18日 MCP 规范更新相关的更改，可能会破坏某些 FastMCP 用户的功能。

依赖管理

将 mcp 依赖项锁定在 1.10 以下

完整更新日志： v2.9.1…v2.9.2

v2.9.1 – 2024年6月26日

版本标题：动态通知支持

FastMCP 2.9.1 引入了自动 MCP 列表变更通知，允许服务器在工具、资源或提示动态更新时通知客户端。这使得 MCP 集成更具响应性和适应性。

新特性

添加自动 MCP 列表变更通知和客户端消息处理

主要改进

为承载令牌认证添加调试日志记录

修复

修复异常处理程序中的重复错误日志记录

修复 OpenAPI 解析器中的参数位置枚举处理

修复 OpenAPI 解析器中的外部模式引用处理

完整更新日志： v2.9.0…v2.9.1

v2.9.0 – 2024年6月23日

版本标题：中间件支持

FastMCP 2.9 引入了两个超越基本 MCP 协议的重要特性：MCP 中间件和服务器端类型转换。

MCP 中间件

MCP 中间件允许您在协议级别拦截和修改请求和响应，为您提供日志记录、认证、验证等强大功能。这对于需要复杂请求处理的生产就绪 MCP 服务器特别有用。

服务器端类型转换

此版本还引入了提示参数的服务器端类型转换，确保在传递给函数之前正确格式化数据。这减少了单个工具和提示处理类型验证和转换的负担。

新特性

为二进制数据添加 File 实用程序

将前缀逻辑整合到 FastMCP 方法中

添加 MCP 中间件

实现提示参数的服务器端类型转换

完整更新日志： v2.8.1…v2.9.0

v2.8.1 – 2024年6月15日

版本标题：音频支持

2.8.1 引入了音频支持，以及对已弃用功能的次要修复和更新。

音频支持

此版本添加了对 MCP 工具和资源中音频内容的支持，扩展了 FastMCP 在文本和图像之外的多媒体功能。

新特性

添加音频支持

主要改进

添加禁用弃用警告的标志

为工具参数转换添加示例

完整更新日志： v2.8.0…v2.8.1

v2.8.0 – 2024年6月10日

版本标题：工具转换

FastMCP 2.8.0 引入了强大的新方法来定制和控制您的 MCP 服务器！

工具转换

此版本的亮点是一流的工具转换，这是一个新功能，让您可以创建现有工具的增强变体。您现在可以轻松重命名参数、隐藏参数、修改描述，甚至使用自定义验证或后处理逻辑包装工具 – 所有这些都无需重写原始代码。

组件控制

此版本还为您提供了对哪些组件暴露给客户端的更细粒度控制。通过新的基于标签的过滤，您可以根据标签选择性地启用或禁用工具、资源和提示，非常适合管理不同环境或用户权限。

工具默认行为

最后，为了改善与更广泛的 LLM 客户端的兼容性，此版本更改了 OpenAPI 集成的默认行为：默认情况下，所有 API 端点现在都转换为工具。

完整更新日志： v2.7.1…v2.8.0

v2.7.1 – 2024年6月8日

版本标题：承载令牌必需品

此版本主要包含对提供给 FastMCP 客户端的字符串令牌解析的修复。

新特性

尊重缓存设置，默认设置为 1 秒

修复

确保事件存储正确类型化

修复将令牌字符串传递给客户端认证并为 MCPConfig 客户端添加认证

完整更新日志： v2.7.0…v2.7.1

v2.7.0 – 2024年6月5日

版本标题：内部重构

这主要是一个维护版本，用于移除或弃用自 v1 以来积累的冗余代码。此版本重构了 FastMCP 的内部结构，为未来几个主要版本中计划的功能做准备。

破坏性变更

装饰器返回它们创建的对象，而不是装饰的函数

websockets 是可选依赖项

服务器上用于自动将函数转换为工具/资源/提示的方法已被弃用，转而直接使用装饰器

主要改进

允许向服务器传递标志

将 Tool 拆分为 Tool 和 FunctionTool

支持灵活的 @tool 装饰器调用模式

允许裸提示装饰器

完整更新日志： v2.6.2…v2.7.0

v2.6.1 – 2024年6月3日

版本标题：认证增强（二次点火）

这是一个修补程序版本，用于恢复 #686 中的 py.typed。

文档

更新认证文档

修复 CLI 文档的路径错误

完整更新日志： v2.6.0…v2.6.1

v2.6.0 – 2024年6月2日

版本标题：认证体系

新特性

引入 MCP 客户端 OAuth 流程

支持在初始化时提供工具

为服务器和客户端添加基本承载认证

支持从环境变量配置承载认证

主要改进

支持从工具定义中排除参数

添加服务器和客户端认证文档

完整更新日志： v2.5.2…v2.6.0

v2.5.2 – 2024年5月29日

版本标题：进程保持存活

新特性

为无法访问的挂载服务器添加优雅的错误处理

从客户端传输改进类型推断

添加 keep_alive 参数以重用子进程

修复

修复处理没有描述的工具

确保影响行为的头部在转发代理/OpenAPI 时被排除

完整更新日志： v2.5.1…v2.5.2

v2.5.1 – 2024年5月24日

版本标题：路由觉醒（第二部分）

修复

确保始终从客户端头部剥离 content-length

完整更新日志： v2.5.0…v2.5.1

v2.5.0 – 2024年5月24日

版本标题：路由觉醒

此版本引入了从 OpenAPI 规范和 FastAPI 应用程序生成和定制 MCP 服务器的全新工具，包括确定哪些路由映射到哪些 MCP 组件的机制；重命名路由；以及定制生成的 MCP 组件。

新特性

为内存中客户端/测试添加 FastMCP 1.0 服务器支持

在 Context.sample 中暴露模型偏好以灵活选择模型

添加客户端方法以发送取消通知

为 OpenAPI 路由添加基于标签的路由映射

添加 OpenAPI 路由创建的高级控制

完整更新日志： v2.4.0…v2.5.0

v2.4.0 – 2024年5月21日

版本标题：配置征服

注意： 此版本包含对在组合服务器中挂载资源时资源前缀方式的向后不兼容更改。但是，只有在运行测试或手动按前缀键加载资源时才是向后不兼容的；LLM 应该不会发现新路由有任何问题。

新特性

允许 * 方法和所有路由作为工具快捷方式

改进配置字典支持

支持从 MCP 配置字典创建客户端，包括多服务器客户端

使资源前缀格式可配置

修复

避免在初始化服务器会话时挂起

破坏性变更

移除可定制的分隔符；改进资源分隔符

完整更新日志： v2.3.5…v2.4.0

v2.3.5 – 2024年5月20日

版本标题：进度报告改进

新特性

在进度通知中支持消息

在 server.run 中添加中间件选项

为应用程序添加 lifespan 属性

更新 fastmcp run 以支持远程服务器

添加 FastMCP.as_proxy()

从包含 /sse 的 URL 推断 sse 传输

为客户端添加进度处理程序

修复

移除补丁并使用上游 SSEServerTransport

完整更新日志： v2.3.4…v2.3.5

v2.3.4 – 2024年5月15日

版本标题：错误处理优化

新特性

为更轻松调试记录堆栈跟踪

在客户端导出中添加缺失的 StreamableHttpTransport

改进工具和资源的错误处理

添加从服务器移除工具的支持

从 JSONSchemas 中修剪标题

为 stdio 服务器声明 toolsChanged 能力

为客户端添加超时支持

修复

将 mcp 锁定到 1.8.1 以解决 SHTTP 的回调死锁问题

完整更新日志： v2.3.3…v2.3.4

v2.3.3 – 2024年5月10日

版本标题：SSE 服务器修复

这是针对在 2.3.2 中引入的破坏 SSE 服务器的错误的紧急修复。

修复

修复将消息路径和 sse 路径设置为相同值的错误

完整更新日志： v2.3.2…v2.3.3

v2.3.2 – 2024年5月10日

版本标题：中间件支持

新特性

允许用户将中间件传递给 starlette 应用程序构造函数

弃用 FastMCP 服务器上特定于传输的方法

主要改进

为 CLI 添加 23 个测试

完整更新日志： v2.3.1…v2.3.2

v2.3.1 – 2024年5月9日

版本标题：嵌套应用修复

此版本主要修补了嵌套 ASGI SSE 服务器中长期存在的错误。

修复

修复工具返回列表时的工具结果序列化

确保 FastMCP 在 ASGI 框架中正确处理嵌套 SSE 和 SHTTP 应用程序

完整更新日志： v2.3.0…v2.3.1

v2.3.0 – 2024年5月8日

版本标题：流式传输支持

新特性

为 HTTP 传输添加流式支持

在客户端中支持流式 HTTP 传输

为 CLI 添加流式支持

修复

修复流式传输初始化

完整更新日志： v2.2.10…v2.3.0

v2.2.10 – 2024年5月6日

版本标题：JSON 处理修复

修复

禁用工具参数的自动 JSON 解析

修复提示测试

完整更新日志： v2.2.9…v2.2.10

v2.2.9 – 2024年5月6日

版本标题：字符串处理修复（紧急修复）

这是针对 #330 中详细问题的紧急修复。

修复

防止无效资源 URI

将数字强制转换为字符串

完整更新日志： v2.2.8…v2.2.9

v2.2.8 – 2024年5月5日

版本标题：解析改进

新特性

用 TypeAdapter 替换自定义解析

为各种组件适当处理 *args/**kwargs

为 SSE 应用程序添加 timeout-graceful-shutdown 作为默认配置

确保提示返回描述

修复

确保工具序列化有优雅的回退

完整更新日志： v2.2.7…v2.2.8

v2.2.7 – 2024年5月3日

版本标题：认证支持

新特性

使用 pydantic_core.to_json

确保 OpenAPI 描述包含在工具详细信息中

为工具添加注解支持

添加认证支持

为客户端添加低级方法

为 FastMCP 上下文添加检索当前 starlette 请求的方法

支持工具的自定义序列化器

支持代理挂载

完整更新日志： v2.2.6…v2.2.7

v2.2.6 – 2024年4月30日

版本标题：REST API 改进

新特性

添加功能：使用配置加载 MCP 服务器

为 OpenAPI 暴露可配置超时

为兼容性降低 websockets 锁定版本

改进 OpenAPI 参数处理

修复

确保 OpenAPI 工具响应正确转换

修复 OpenAPI 示例

修复客户端高级功能文档，为日志记录添加测试

完整更新日志： v2.2.5…v2.2.6

v2.2.5 – 2024年4月26日

版本标题：上下文注入扩展

新特性

为工具返回类型添加测试；改进序列化行为

在资源、模板和提示中支持上下文注入（类似于工具）

文档

为工具输入类型扩展重要文档和测试

完整更新日志： v2.2.4…v2.2.5

v2.2.4 – 2024年4月25日

版本标题：通配符支持实际启用

v2.2.3 中暴露的通配符 URI 模板被服务器级检查阻止，此版本移除了该检查。

新特性

允许自定义检查器代理端口、UI 端口和版本

修复

修复意外的类型转换

确保 OpenAPI 资源返回有效响应

确保服务器暴露模板通配符

完整更新日志： v2.2.3…v2.2.4

v2.2.3 – 2024年4月25日

版本标题：通配符支持

新特性

为资源模板添加通配符参数

完整更新日志： v2.2.2…v2.2.3

v2.2.2 – 2024年4月24日

版本标题：提示支持

新特性

添加提示支持

修复

确保资源模板正确暴露

完整更新日志： v2.2.1…v2.2.2

v2.2.1 – 2024年4月23日

版本标题：资源模板

新特性

添加资源模板

修复

确保资源模板正确暴露

完整更新日志： v2.2.0…v2.2.1

v2.2.0 – 2024年4月22日

版本标题：服务器组合

新特性

添加挂载 FastMCP 服务器支持

添加重复行为 == ignore 的支持

破坏性变更

重构 MCP 组合

完整更新日志： v2.1.2…v2.2.0

v2.1.2 – 2024年4月14日

版本标题：对象复制修复

此版本的主要改进是修复了允许 FastAPI / OpenAPI 生成的服务器作为子服务器挂载的问题。

修复

确保对象正确复制并测试挂载 fastapi

完整更新日志： v2.1.1…v2.1.2

v2.1.1 – 2024年4月14日

版本标题：文档发布

FastMCP 的文档现在可在 gofastmcp.com 上找到。

文档

添加文档

在 readme 中添加文档链接

完整更新日志： v2.1.0…v2.1.1

v2.1.0 – 2024年4月13日

版本标题：标签支持

此版本的主要动机是修复 #128 中与 Claude desktop 兼容性的问题，但此版本的主要新功能是每个对象的标签。

新特性

为核心 MCP 对象添加标签

确保 OpenAPI 标签传输到 MCP 对象

修复

将默认挂载工具分隔符从 / 更改为 _

进入挂载应用程序生命周期

完整更新日志： v2.0.0…v2.1.0

v2.0.0 – 2024年4月11日

版本标题：第二代发布

新特性

支持将 FastMCP 实例挂载为子 MCP

为调用 FastMCP 服务器添加内存客户端（和测试）

添加 MCP 代理服务器

从 OpenAPI 规范和 FastAPI 生成 FastMCP 服务器

添加采样和根

修复

修复返回列表的工具的错误

完整更新日志： v1.0…v2.0.0

v1.0 – 2024年4月11日

版本标题：官方发布

此版本纪念 FastMCP 1.0，它包含在官方 Model Context Protocol SDK 中：

from mcp.server.fastmcp import FastMCP

据我所知，v1 与包含在 mcp 中的上游版本相同。

完整更新日志： v0.4.1…v1.0

更多相关视频教程

👉 《FastMCP快速入门教程》

更多文章专栏内容

FastMCP 快速入门相关文章：
👉《01_FastMCP 2.x 干货笔记之 FastMCP 的介绍》
👉《02_FastMCP 2.x 干货笔记之 FastMCP 安装指南》
👉《03_FastMCP 2.x 干货笔记之 FastMCP 快速入门指南》
👉《04_FastMCP 2.x 干货笔记之 FastMCP 更新日志》

FastMCP 服务端相关文章：
👉《05_FastMCP 2.x 干货笔记之 FastMCP 服务端概述》
👉《06_FastMCP 2.x 干货笔记之 FastMCP 服务端核心组件：工具详解》
👉《07_FastMCP 2.x 干货笔记之 FastMCP 服务端核心组件：资源与模板详解》
👉《08_FastMCP 2.x 干货笔记之 FastMCP 服务端核心组件：提示模板详解》
👉《09_FastMCP 2.x 干货笔记之 FastMCP 服务端高级功能：服务器组成详解》
👉《10_FastMCP 2.x 干货笔记之 FastMCP 服务端高级功能：上下文详解》
👉《11_FastMCP 2.x 干货笔记之 FastMCP 服务端高级功能：用户引导详解》
👉《12_FastMCP 2.x 干货笔记之 FastMCP 服务端高级功能：图标详解》
👉《13_FastMCP 2.x 干货笔记之 FastMCP 服务端高级功能：客户端日志记录详解》
👉《14_FastMCP 2.x 干货笔记之 FastMCP 服务端高级功能：MCP中间件详解》
👉《15_FastMCP 2.x 干货笔记之 FastMCP 服务端高级功能：进度报告详解》
👉《16_FastMCP 2.x 干货笔记之 FastMCP 服务端高级功能：代理服务器详解》
👉《17_FastMCP 2.x 干货笔记之 FastMCP 服务端高级功能：LLM采样详解》
👉《18_FastMCP 2.x 干货笔记之 FastMCP 服务端高级功能：后端存储详解》
👉《19_FastMCP 2.x 干货笔记之 FastMCP 服务端认证概述》
👉《20_FastMCP 2.x 干货笔记之 FastMCP 服务端认证：令牌验证详解》
👉《21_FastMCP 2.x 干货笔记之 FastMCP 服务端认证：远程 OAuth 详解》
👉《22_FastMCP 2.x 干货笔记之 FastMCP 服务端认证：OAuth 代理详解》
👉《23_FastMCP 2.x 干货笔记之 FastMCP 服务端认证：OIDC 代理详解》
👉《24_FastMCP 2.x 干货笔记之 FastMCP 服务端认证：构建完整的 OAuth 服务器详解》
👉《25_FastMCP 2.x 干货笔记之 FastMCP 服务端部署：本地运行指南》
👉《26_FastMCP 2.x 干货笔记之 FastMCP 服务端部署：HTTP 部署指南》
👉《27_FastMCP 2.x 干货笔记之 FastMCP 服务端部署：FastMCP Cloud 部署指南》
👉《28_FastMCP 2.x 干货笔记之 FastMCP 服务端部署：项目配置详解》

FastMCP 客户端相关文章：
👉《29_FastMCP 2.x 干货笔记之 FastMCP 客户端要点概述》
👉《30_FastMCP 2.x 干货笔记之 FastMCP 客户端要点传输方式》
👉《31_FastMCP 2.x 干货笔记之 FastMCP 客户端核心业务：工具操作详解》
👉《32_FastMCP 2.x 干货笔记之 FastMCP 客户端核心业务：资源操作详解》
👉《33_FastMCP 2.x 干货笔记之 FastMCP 客户端核心业务：提示模板详解》
👉《34_FastMCP 2.x 干货笔记之 FastMCP 客户端高级功能：处理服务端发起的用户引导详解》
👉《35_FastMCP 2.x 干货笔记之 FastMCP 客户端高级功能：接收并处理服务端日志详解》
👉《36_FastMCP 2.x 干货笔记之 FastMCP 客户端高级功能：接收并处理服务端进度报告详解》
👉《37_FastMCP 2.x 干货笔记之 FastMCP 客户端高级功能：处理服务端发起的LLM采样请求》
👉《38_FastMCP 2.x 干货笔记之 FastMCP 客户端高级功能：接收并处理服务端消息详解》
👉《39_FastMCP 2.x 干货笔记之 FastMCP 客户端高级功能：设置客户端根目录》
👉《40_FastMCP 2.x 干货笔记之 FastMCP 客户端认证：OAuth 身份验证详解》
👉《41_FastMCP 2.x 干货笔记之 FastMCP 客户端认证：Bearer 令牌认证详解》

FastMCP 集成相关文章：
👉《42_FastMCP 2.x 干货笔记之 FastMCP 集成：Auth0 认证指南》
👉《43_FastMCP 2.x 干货笔记之 FastMCP 集成：AuthKit 认证指南》
👉《44_FastMCP 2.x 干货笔记之 FastMCP 集成：AWS Cognito 认证指南》
👉《45_FastMCP 2.x 干货笔记之 FastMCP 集成：Azure (Entra ID) 认证指南》
👉《46_FastMCP 2.x 干货笔记之 FastMCP 集成：Descope 认证指南》
👉《47_FastMCP 2.x 干货笔记之 FastMCP 集成：GitHub 认证指南》
👉《48_FastMCP 2.x 干货笔记之 FastMCP 集成：Scalekit 认证指南》
👉《49_FastMCP 2.x 干货笔记之 FastMCP 集成：Google 认证指南》
👉《50_FastMCP 2.x 干货笔记之 FastMCP 集成：WorkOS 认证指南》
👉《51_FastMCP 2.x 干货笔记之 FastMCP 集成：Eunomia 授权指南》
👉《52_FastMCP 2.x 干货笔记之 FastMCP 集成：Permit.io 授权指南》
👉《53_FastMCP 2.x 干货笔记之 FastMCP 集成AI助手：ChatGPT 指南》
👉《54_FastMCP 2.x 干货笔记之 FastMCP 集成AI助手：Claude Code 指南》
👉《55_FastMCP 2.x 干货笔记之 FastMCP 集成AI助手：Claude Desktop 指南》
👉《56_FastMCP 2.x 干货笔记之 FastMCP 集成AI助手：Cursor 指南》
👉《57_FastMCP 2.x 干货笔记之 FastMCP 集成AI助手：Gemini CLI 指南》
👉《58_FastMCP 2.x 干货笔记之 FastMCP 集成AI助手：MCP JSON 配置指南》
👉《59_FastMCP 2.x 干货笔记之 FastMCP 集成 AI SDK：Anthropic API 指南》
👉《60_FastMCP 2.x 干货笔记之 FastMCP 集成 AI SDK：Gemini SDK 指南》
👉《61_FastMCP 2.x 干货笔记之 FastMCP 集成 AI SDK：OpenAI API 指南》
👉《62_FastMCP 2.x 干货笔记之 FastMCP 集成 API：FastAPI 指南》
👉《63_FastMCP 2.x 干货笔记之 FastMCP 集成 API：OpenAPI 指南》

FastMCP 核心模式相关文章：
👉《64_FastMCP 2.x 干货笔记之 FastMCP 核心模式：工具转换》
👉《65_FastMCP 2.x 干货笔记之 FastMCP 核心模式：装饰方法》
👉《66_FastMCP 2.x 干货笔记之 FastMCP 核心模式：FastMCP CLI》
👉《67_FastMCP 2.x 干货笔记之 FastMCP 核心模式：贡献模块》
👉《68_FastMCP 2.x 干货笔记之 FastMCP 核心模式：测试 FastMCP 服务器》

参与 FastMCP 开发相关文章：
👉《69_FastMCP 2.x 干货笔记之参与 FastMCP 开发：贡献代码指南》
👉《70_FastMCP 2.x 干货笔记之参与 FastMCP 开发：测试模式和要求》
👉《71_FastMCP 2.x 干货笔记之参与 FastMCP 开发：版本管理和发布流程》
👉《72_FastMCP 2.x 干货笔记之参与 FastMCP 开发：版本升级指南》
👉《73_FastMCP 2.x 干货笔记之参与 FastMCP 开发：版本完整更新日志》