PrefectHQ GitHub avatar

fastmcp

Python
MCP开发框架PrefectHQ最近推送 2026年11月19日
MCP 与工具接入Apache-2.028.7k2,624246 issues7 天 +267

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日

用 Python 快速构建 MCP 服务器和客户端的框架。

FastMCP 是 Prefect 团队开发的 MCP 应用框架,提供服务器、客户端和交互式应用三部分能力。它让开发者用普通 Python 函数声明工具,自动生成 schema、校验和文档,并处理传输协商、认证和协议生命周期。

推荐指数

5.0

MCP 生态中成熟度最高、使用最广的 Python 框架,适合作为构建 MCP 应用的首选。

近 7 天

+267

新增 Star

总 Star 排名

#253

雷达追踪的 3,958 个 AI 仓库中

创建于

2024

2024年11月30日

核心亮点

  • 1函数即工具

    用 @mcp.tool 装饰普通 Python 函数,schema、校验和文档自动生成。

  • 2客户端全协议

    通过 URL 连接任意 MCP 服务器,传输协商、认证和生命周期由框架管理。

  • 3交互式应用

    支持在对话中直接渲染工具 UI,扩展 MCP 的交互形态。

  • 4生态标准

    FastMCP 1.0 已并入官方 MCP Python SDK,独立项目日下载量达百万级。

  • 5文档完善

    提供完整文档站和 llms.txt 格式,方便 LLM 直接读取。

适用场景

  • 为 AI Agent 接入外部能力

    例如:把数据库查询函数包装成 MCP 工具,供 LLM 调用。

  • 连接远程 MCP 服务

    例如:用 FastMCP 客户端连接公司内部部署的 MCP 服务器并调用其工具。

  • 构建带 UI 的工具

    例如:在对话中渲染一个可交互的表单工具界面。

它是怎么工作的

  1. 第 1 步

    声明工具

    用 @mcp.tool 装饰 Python 函数,框架自动生成输入 schema 和文档。

  2. 第 2 步

    启动服务器

    调用 mcp.run() 启动 MCP 服务器,对外暴露工具、资源和提示。

  3. 第 3 步

    客户端连接

    客户端通过 URL 或本地方式连接服务器,框架处理传输和认证。

  4. 第 4 步

    协议交互

    LLM 按 MCP 协议发现并调用工具,框架管理整个生命周期。

快速上手

  1. 1

    安装

    推荐用 uv 将 FastMCP 加入项目依赖。

    uv add fastmcp
  2. 2

    写一个工具

    创建 FastMCP 实例并用 @mcp.tool 装饰函数。

  3. 3

    运行服务器

    在 __main__ 中调用 mcp.run() 启动。

适合谁

  • 需要为 LLM 或 Agent 暴露工具的 Python 开发者
  • 要连接远程 MCP 服务器的应用开发者
  • 希望减少 MCP 协议样板代码的团队

不太适合

  • 主要使用 TypeScript 的开发者(应选 fastmcp-ts)
  • 不需要 MCP 协议、只想做普通 API 的项目

成熟度

  • 活跃度最近一次推送在 2026 年 11 月,持续活跃维护。
  • 文档有独立文档站、升级指南和 llms.txt 格式。
  • 社区2.8 万 star、2600 多 fork,有 Discord 社区。
  • 上手难度几行 Python 即可启动服务器,上手门槛低。

同类项目怎么选

  • 官方 MCP Python SDK更底层,FastMCP 1.0 曾并入其中,独立版功能更全、更新更快。
  • fastmcp-ts同团队维护的 TypeScript 版本,面向 Node 生态。

使用前注意

  • · 采用 Apache-2.0 许可,商用需保留版权声明。
  • · 项目迭代较快,升级前应阅读对应版本的升级指南。
  • · 企业级治理、SSO 和审计等能力需配合商业产品 FastMCP Gateway。

主题标签

model-context-protocolfastmcpmcpagentsllmsmcp-clientsmcp-serversmcp-toolspython