FastAPI秒变MCP工具!一键解锁大模型调用能力
在AI应用开发中,将现有API快速转化为大模型可调用的工具(Tool)已成为刚需。今天介绍的神器FastAPI-MCP,只需3行代码就能将你的FastAPI接口秒变Model Context Protocol(MCP)工具,并自带完整认证体系!
🔥 核心功能亮点
- 无缝认证集成
复用现有FastAPI的Depends()
机制,OAuth2/JWT等认证方案直接生效
# 原生支持FastAPI依赖项
mcp = FastApiMCP(app, dependencies=[Depends(verify_token)])
- 零配置转换
自动保留所有接口的请求/响应模型和Swagger文档,无需额外声明
# 自动转换所有端点
mcp.mount() # MCP服务生成于 /mcp
- 高性能ASGI通道
通过FastAPI原生ASGI接口通信,避免HTTP网络开销
🚀 典型应用场景
- AI Agent开发
快速将企业内部API(CRM/ERP)转化为Claude/GPT可调用的工具 - 智能客服系统
将知识库查询接口暴露为AI工具,实现自动答疑 - 自动化工作流
把审批接口封装成工具,大模型自动触发业务流程
💻 三步接入指南
- 安装SDK(推荐uv加速):
uv add fastapi-mcp
- 挂载到现有应用:
from fastapi import FastAPI
from fastapi_mcp import FastApiMCP
app = FastAPI()
mcp = FastApiMCP(app).mount() # 启用/mcp端点
- 大模型直接调用:
// MCP协议标准请求体
{
"tool_id": "get_user_info",
"parameters": {"user_id": "U12345"}
}
⚡️ 进阶技巧
- 选择性暴露:通过
include_routers
参数控制开放的工具 - 独立部署:支持与主服务分离运行(适合生产环境)
- 文档保留:自动转换Swagger注释为工具描述
🌟 项目优势
相比传统OpenAPI转MCP方案:
- ✅ 原生支持FastAPI依赖注入系统
- ✅ 免去HTTP转发层,性能提升5X+
- ✅ 实时同步接口变更,无需手动维护
项目已获8.9k Stars,支持Python 3.10+
GitHub:https://github.com/tadata-org/fastapi_mcp
文档:https://fastapi-mcp.tadata.com/
💡 同类方案对比
| 项目 | 认证支持 | 原生集成 | 协议兼容 |
|——|———-|———-|———-|
| FastAPI-MCP | ✅ | ✅ | MCP v2 |
| OpenAPI-to-Tools | ❌ | ❌ | 部分兼容 |
| LangChain Tools | ✅ | ❌ | 自定义协议 |
(附:演示GIF请查看项目主页,展示实时转换效果)
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END
暂无评论内容