FastMCP：构建 MCP 应用的标准框架，日下载量达百万次！

转载于 2026-07-21 08:47:10 发布 · 11 阅读

FastMCP：快速行动，创造价值

FastMCP 由 Prefect 打造。模型上下文协议（Model Context Protocol, MCP）可将大语言模型（LLMs）与工具和数据连接起来。FastMCP 提供了从原型到生产所需的一切，以下为示例代码：

from fastmcp import FastMCP
mcp = FastMCP("Demo 🚀")

@mcp.tool
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b

if __name__ == "__main__":
    mcp.run()

为何选择 FastMCP

构建有效的 MCP 应用程序颇具难度，而 FastMCP 能处理好一切。用户只需用 Python 函数声明一个工具，其模式、验证和文档就会自动生成。通过 URL 连接到服务器，传输协商、身份验证和协议生命周期也会由它管理。用户只需专注于业务逻辑，MCP 部分自然会正常运行，因为 FastMCP 内置了最佳实践。所以，FastMCP 是使用 MCP 的标准框架。

2024 年，FastMCP 1.0 被纳入官方 MCP Python SDK。如今，这个积极维护的独立项目每天的下载量达百万次，70% 跨语言的 MCP 服务器都由某个版本的 FastMCP 提供支持。

FastMCP 的三大支柱

服务器（Servers）：向大语言模型（LLMs）公开工具、资源和提示。
应用程序（Apps）：为工具提供可直接在对话中渲染的交互式用户界面（UI）。
客户端（Clients）：连接到任何 MCP 服务器，无论是本地还是远程的，支持编程式或命令行界面（CLI）操作。

服务器将 Python 函数封装成符合 MCP 标准的工具、资源和提示；客户端能以完整的协议支持连接到任何服务器；应用程序则为工具提供可直接在对话中渲染的交互式 UI。

准备好开始构建了吗？可以先查看安装指南，或者直接快速上手。

使用 Horizon 在生产环境中运行 FastMCP

FastMCP 是构建 MCP 服务器的标准方式，而 Prefect Horizon 则是安全运行这些服务器的企业级 MCP 网关。由 FastMCP 团队打造的 Horizon 集成了在发布全球最受欢迎的 MCP 框架过程中积累的最佳实践。用户可以从 GitHub 部署 FastMCP 服务器，支持分支预览和即时回滚；为公司使用的每个 MCP 创建私有注册表；通过单点登录（SSO）和工具级基于角色的访问控制（RBAC）确保访问安全；获取整个 MCP 栈的审计日志、可观测性和治理功能；将经过审批的工具重新组合成适用于团队和代理的专用端点。

从 FastMCP 开始，借助 Horizon 进行扩展。

安装

建议使用 `uv` 安装 FastMCP：

uv pip install fastmcp

如需完整的安装说明，包括验证和升级步骤，请参阅安装指南。

升级说明

提供以下升级指南：

从 FastMCP v2 升级
从 MCP Python SDK 升级
从底层 SDK 升级

注意：如果在从 FastMCP 3.2 或更早版本进行 `pip` 升级后，`import fastmcp` 失败，请运行 `pip install --force - reinstall fastmcp`。有关此问题的原因，请参阅故障排除（使用 `uv` 不受影响）。

📚 文档

FastMCP 的完整文档可在 [gofastmcp.com](gofastmcp.com) 上查看，其中包括详细指南、API 参考和高级模式。文档也提供 `llms.txt` 格式，这是一种大语言模型（LLMs）易于处理的简单 Markdown 标准。`llms.txt` 本质上是一个站点地图，列出了文档中的所有页面；`llms - full.txt` 则包含完整的文档内容。请注意，这可能会超出大语言模型的上下文窗口。