← 返回目录

FastAPI-MCP

社区

框架 / SDK

将FastAPI端点暴露为MCP工具，并支持认证！

这是用于开发 MCP Server 或 Agent 的框架，不是可以直接连接到客户端的 Server。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 280 / 438
Stars: ★ 12.0k 热门
传输方式: Streamable HTTP
运行环境: Python 3.10+
凭据: 无需凭据
许可证: MIT
最近提交: 14 个月前 ⚠

48FMRS · D

FastAPI-MCP是一个成熟的库，用于将FastAPI端点转换为MCP工具，并提供认证支持。它采用FastAPI原生方法，使其对现有FastAPI用户特别有用。文档和示例非常全面，社区活跃，拥有MIT许可证。它不适用于非FastAPI项目，可能需要谨慎处理敏感端点的安全问题。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

10/20

维护活跃度

10/20

文档质量

10/20

安装易用性

12/20

查看各项评分依据

可靠性 6/20: 仅基于 README：展示了 FastApiMCP(app) 和 mount() 的最小用法，宣称可自动生成 MCP 工具并使用 ASGI 传输。但未提供任何源码、测试或 CI 执行证据，无法验证初始化握手、工具列表与真实行为是否一致，也未说明边界条件与错误处理。按静态审查规则，缺少执行证据即扣分，故给予低分。
安全与权限 10/20: 未发现恶意代码、凭据窃取、隐蔽外传或破坏性默认值，未触发红线。README 明确说明使用现有 FastAPI 依赖进行身份验证，这是优点。但默认将全部端点暴露为 MCP 工具，未见工具级白名单/最小权限、危险操作确认或数据流动说明，凭据的存储和传输细节也未提供。因此给 10 分。
维护活跃度 10/20: 仓库显示 MIT 许可证、未归档、版权归 Tadata Inc.，README 中有 CI/覆盖率徽标，但徽标属于不可信证据。未提供提交频率、版本发布节奏、依赖更新或安全响应渠道；open issues 164 条来自元数据，不能直接加分。由于所有权和许可证明确，给 10 分，但因治理/更新路径证据不足而无法更高。
文档质量 10/20: README 提供了安装方式、基本用法、特性说明，并链接到文档站和 examples 目录，文档分层可期。但未提供认证配置细节、工具参数说明、限制/成本、故障排查；外部文档链接在本审查中不可验证。属于可用但有隐藏假设和排查缺口，故 10 分。
安装易用性 12/20: 安装步骤清晰：uv add fastapi-mcp 或 pip install，然后三行代码 mount 到 /mcp。但未提供主流客户端（Claude/Cursor/Windsurf）的连接配置示例，也没有平台兼容性说明；README 中无真实 CI/测试证据，因此按静态校准不能超过 15，综合给 12 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

已部署FastAPI应用的开发者，希望以最小配置添加MCP支持。
需要确保MCP端点安全，并利用现有FastAPI依赖进行认证和授权的团队。
希望将MCP服务器与FastAPI应用一起部署，或作为独立服务部署的场景。

不适合谁

尚未使用FastAPI的开发者——此服务器针对FastAPI应用设计。
需要支持stdio传输的客户端——FastAPI-MCP使用ASGI/HTTP传输。
需要完全控制MCP工具定义，而不依赖自动从端点生成的用户。

所需权限

需要访问您的FastAPI应用实例。
可能要求MCP端点具备网络访问权限（例如，通过HTTP）。
认证和授权使用您FastAPI应用中现有的依赖项。

风险与副作用

如果认证配置不当，暴露的MCP端点可能会成为未经授权访问的入口。
自动生成的工具可能暴露敏感端点——请确保正确配置认证和授权。
依赖FastAPI版本和Python版本的兼容性——需要Python 3.10+。

安装接入

准备工作

运行环境：Python 3.10+

使用uv或pip安装FastAPI-MCP：

uv add fastapi-mcp

或者

pip install fastapi-mcp

验证是否装好

安装 fastapi-mcp 并在 FastAPI 应用上运行 FastApiMCP(app).mount() 后，用 MCP 客户端连接 https://app.base.url/mcp，应能看到由你的 FastAPI 端点自动生成的工具列表。

常见排障

确保您使用的是Python 3.10或更高版本。
验证FastAPI应用是否正确初始化，且MCP服务器已挂载。
检查认证依赖项是否按预期工作，以防出现权限错误。
查看文档和示例，了解高级配置和部署选项。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

把我 FastAPI 应用里的所有端点作为 MCP 工具列出来
调用我 API 中的某个 GET 端点并返回结果
描述这个 FastAPI MCP 服务器暴露的某个端点的请求和响应模型

使用场景

将现有FastAPI服务暴露为MCP工具，供Claude、Cursor或Windsurf等AI客户端使用。

为AI代理提供受保护的API端点访问，并利用现有FastAPI认证机制。

无需重写API代码，即可将MCP功能快速集成到FastAPI服务中。

详细介绍

FastAPI-MCP是一个旨在将现有FastAPI应用程序转换为模型上下文协议（MCP）服务器的库。它不是简单的OpenAPI到MCP转换器，而是FastAPI的原生扩展，允许您将MCP服务器直接挂载到FastAPI应用上。它内置了使用现有FastAPI依赖项的认证功能，保留请求和响应模型的架构，保留了Swagger中已有的文档，并支持灵活部署——您可以将MCP服务器挂载到同一个应用，也可以单独部署。它使用ASGI传输直接与FastAPI应用通信，无需HTTP调用。

FastAPI-MCP

选型与风险

适合谁

不适合谁

所需权限

风险与副作用

安装接入

准备工作

验证是否装好

常见排障

试试这样问

使用场景

详细介绍

同类可选方案