FastAPI

FastAPI-MCP 是什么

FastAPI-MCP 是一款开源工具，能够将 FastAPI 应用中的端点自动转换为符合模型上下文协议（MCP）的格式。该工具具备零配置特性，用户只需指向 FastAPI 应用，即可自动发现并转换所有端点，无需额外设置。FastAPI-MCP 保留了 FastAPI 的请求与响应模型结构以及 Swagger 文档，确保接口的完整性和易用性。它支持直接集成到 FastAPI 应用中，也可独立部署，便于灵活使用。

FastAPI-MCP 的主要功能

• 自动发现与转换：FastAPI-MCP 能够自动识别并转换 FastAPI 应用中的所有端点为 MCP 工具，无需手动配置。
• 保留模式与文档：工具保留 FastAPI 的请求和响应模型结构以及 Swagger 文档，确保接口信息的一致性。
• 灵活部署：支持将 MCP 服务器挂载至 FastAPI 应用或单独部署，满足不同场景需求。
• 自定义工具命名：基于路由中的 operation_id 自动命名 MCP 工具，支持手动定义更清晰的名称。
• 筛选暴露的端点：通过 OpenAPI 操作 ID 或标签控制哪些端点被暴露为 MCP 工具。
• 支持 SSE 和代理连接：支持 SSE 协议连接，亦可通过代理实现对不支持 SSE 客户端的支持。
• 动态更新：新增端点后可调用方法刷新 MCP 服务器，实现动态更新。

FastAPI-MCP 的技术原理

• 利用 FastAPI 的 OpenAPI 规范：通过解析 FastAPI 的 OpenAPI 文档提取元数据，生成对应的 MCP 工具。
• 反射式元数据捕获与动态路由注册：基于 FastAPI 类型系统和反射机制，自动捕获接口信息并动态注册路由。
• AST 语法树解析：通过 AST 解析装饰器，提取接口元信息，实现端点的自动发现。
• 异步任务编排：依托 Starlette 事件循环机制，实现高效的异步任务处理。
• 保留请求与响应模式：保持原有请求和响应结构，确保 AI 调用时的数据一致性。

FastAPI-MCP 的项目地址

• Github 仓库：https://github.com/tadata-org/fastapi_mcp

FastAPI-MCP 的应用场景

• 企业内部自动化：将企业 FastAPI 接口转换为 MCP 工具，供 AI 或自动化系统调用。
• AI 驱动的应用开发：让 AI 模型直接调用后端服务接口。
• 数据分析与处理：AI 代理可通过 MCP 工具访问数据处理接口。
• 内容管理：AI 工具调用 CMS 接口完成内容操作。
• 电子商务：AI 助手通过 API 实现库存查询、下单等功能。