fastapi_mcp
活跃·★ 12.0k·MIT·更新于 2025-11-24
★ 最受欢迎★ 必备神器
FastAPI-MCP 可以把现有 FastAPI 应用的接口开放为 Model Context Protocol 工具，并支持身份认证。你不需要另外编写一个 MCP Server，只要把它指向你的 FastAPI 应用，它就会根据路由生成工具，并保留请求和响应的 schema，以及你已经为 Swagger 写好的接口文档。
它适合已经有 FastAPI 后端、希望让 AI 助手或 Agent 调用这些接口的团队。由于它是 FastAPI 原生的，而不是通用的 OpenAPI 转 MCP 工具，它可以复用你现有的 FastAPI 依赖来做认证，并通过 ASGI 接口直接与应用通信，效率更高，也省去了一次额外的 HTTP 请求。MCP Server 可以挂载在同一个应用上，也可以单独部署。作者还提供托管服务。
上手方式：执行 `uv add fastapi-mcp`（或使用 pip），用你的应用创建一个 `FastApiMCP` 对象并挂载。连接客户端之前，先检查一遍开放了哪些接口。
#FastAPI#MCP (模型上下文协议)#Python#API工具#认证
01
功能特性
01内置认证，复用现有FastAPI依赖！
02FastAPI原生：并非简单的OpenAPI转MCP转换器
03零/极少配置要求
04保留请求和响应模型的架构
05灵活部署——可将MCP服务器挂载到同一应用，或独立部署
02
为什么选择它
+只需很少的配置，就能把现有的 FastAPI 应用变成 MCP 工具。
+复用现有的 FastAPI 依赖来做身份认证。
+保留 schema 和接口文档，模型能拿到清晰的工具描述。
+高效的 ASGI 传输，部署方式灵活；采用 MIT 许可。
03
权衡点
!仓库自 2025 年 11 月以来没有更新，使用前请确认与当前 MCP 客户端和协议版本的兼容性。
!默认开放所有接口，可能让 Agent 拥有超出预期的权限；请过滤接口，尤其是写操作。
!只适用于 FastAPI；其他 Python Web 框架需要采用别的方案。
05
维护状况检查
停滞检查日期: 2026-10-25
- 最近提交
- 2025-08-10
- 近 90 天提交数
- 0
- 近 90 天发布数
- 0
- 最新发布
- v0.4.0 (2025-07-28)
- 未关闭 issue
- 174
- 近期 issue 至少有一条评论的比例
- 5/15
近 12 周每周提交数
最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。
状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #189 [BUG] MCP session 404 in multi worker production environment9 条评论 · 2025-07-02
- #208 [VOTE] Support Stateful Sessions in a Multi-Worker Environment, Using a Shared Session Store7 条评论 · 2025-07-29
- #18 Issues integrating with Cline7 条评论 · 2025-03-22
- #154 Support POST requests on main route6 条评论 · 2025-05-29
- #72 [BUG] Cant get the server communicating to Claude correctly6 条评论 · 2025-04-16
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
04
适合谁
适合选它的情况
- 你已经有现成的 FastAPI 应用，希望直接复用现有的 FastAPI 鉴权依赖与 Swagger Schema，将接口一键暴露为 MCP 工具。
- 希望将 MCP 服务直接挂载到现有 ASGI 应用中或独立部署（MIT 许可）。
建议换别的情况
- 你是从零构建独立的 MCP Server，而非包装已有的 FastAPI 服务；应使用 FastMCP 或官方 MCP Python SDK。
- 你要求依赖库近期持续高频更新（该仓库最后一次推送在 2025 年 11 月）。
06
与同类的区别
vs fastmcp★ 28.2kFastAPI-MCP 将已有的 FastAPI Web 路由自动映射为 MCP 工具；FastMCP 则是持续活跃维护的通用 MCP 服务端与客户端开发框架。
07
兼容性
FastAPI
原生支持
已通过文档验证
Model Context Protocol
MCP工具提供者
已通过文档验证
Python
Python 3.10+支持
已通过文档验证
08
快速开始
1
$ uv add fastapi-mcp
09
使用场景
↳将FastAPI服务作为支持MCP的大型语言模型（LLM）的工具进行集成。
↳使LLM能够与通过FastAPI公开的现有业务逻辑和数据进行交互和利用。
↳在MCP生态系统中快速公开已认证的FastAPI API作为可发现和可用的工具。
10
同类工具
fastmcp★ 28.2k
FastMCP 是一个用于连接大型语言模型 (LLM) 到工具和数据的 Python 框架，旨在简化从原型到生产的 MCP (Model Context Protocol) 应用开发。
mcp-use★ 10.8k
mcp-use 是一个全栈框架，提供使用模型上下文协议（MCP）构建MCP服务器、客户端和AI代理所需的一切，支持Python和TypeScript，最少只需6行代码。
收录于以下清单
评论
登录后发表评论
暂无评论，来发表第一条吧