FastAPI-MCP 是一款零配置工具，可让 FastAPI 应用自动暴露所有端点，并兼容 Model Context Protocol (MCP)。
这意味着你的 FastAPI 应用不仅能被传统客户端调用，还能无缝对接 Claude Desktop、Cursor 等 AI 代理工具，实现更智能的 API 交互。
? FastAPI-MCP 是什么？
FastAPI-MCP 是一款零配置工具，可让 FastAPI 应用自动兼容 Model Context Protocol (MCP)，从而：
✅ 一行代码集成 —— 直接在 FastAPI 挂载 MCP 服务器，无需改动现有代码
✅ 自动发现 API —— 无需额外配置，所有端点自动转换为 MCP 工具
✅ 保留 API 文档 —— 你的 Swagger 文档可在 MCP 生态中直接访问
✅ 支持自定义扩展 —— 允许额外定义 MCP 工具，增强 API 能力
你的 FastAPI 应用，从此不仅能被传统客户端调用，还能变身智能 API 服务器，供 AI 代理工具高效交互！
安装 FastAPI-MCP
你可以通过 pip 或 uv 进行安装：
# 使用 uv（推荐）
uv add fastapi-mcp
# 或使用 pip
pip install fastapi-mcp快速上手
假设你已经有一个 FastAPI 应用，现在**只需一行代码**，就能让它支持 MCP：
from fastapi import FastAPI
from fastapi_mcp import add_mcp_server
# 创建 FastAPI 应用
app = FastAPI()
# 挂载 MCP 服务器
add_mcp_server(
app, # FastAPI 应用
mount_path="/mcp", # MCP 服务器路径
name="My API MCP", # MCP 服务器名称
)这样，你的 MCP 服务器就可以通过 https://your-app.com/mcp 访问了！?
进阶用法
FastAPI-MCP 还支持自定义 API 配置，比如：
? 启用完整 JSON Schema，适配不同的 LLM 工具
? 显示所有可能的响应模式，让 API 更直观
? 手动扩展 MCP 工具，增强交互能力
示例代码：
from fastapi import FastAPI
from fastapi_mcp import add_mcp_server
app = FastAPI()
# 创建 MCP 服务器并启用高级配置
mcp_server = add_mcp_server(
app,
mount_path="/mcp",
name="My API MCP",
describe_all_responses=True, # 显示所有可能的响应模式
describe_full_response_schema=True# 提供完整 JSON Schema
)
# 额外添加一个 MCP 工具（获取服务器时间）
@mcp_server.tool()
asyncdefget_server_time() -> str:
"""获取服务器当前时间"""
from datetime import datetime
return datetime.now().isoformat()这样，你的 MCP 服务器不仅支持 API 自动转换，还能扩展自定义 AI 工具！
? 连接 MCP 服务器
FastAPI-MCP 支持 SSE（Server-Sent Events） 和 mcp-proxy 两种方式，轻松对接 AI 工具：
1️⃣ SSE 方式（适用于 Cursor）
-
1. 运行 FastAPI 应用 -
2. 在 Cursor 设置中，填写 MCP 服务器 URL（如 http://localhost:8000/mcp） -
3. Cursor 将自动发现所有 API 端点
2️⃣ mcp-proxy 方式（适用于 Claude Desktop）
如果 MCP 客户端不支持 SSE（如 Claude Desktop），可以使用 mcp-proxy 代理：
安装 mcp-proxy
uv tool install mcp-proxy
配置 Claude Desktop
在 claude_desktop_config.json 中添加 MCP 代理配置：
Windows
{
"mcpServers": {
"my-api-mcp-proxy": {
"command": "mcp-proxy",
"args": ["http://127.0.0.1:8000/mcp"]
}
}
}MacOS
{
"mcpServers": {
"my-api-mcp-proxy": {
"command": "/Full/Path/To/Your/Executable/mcp-proxy",
"args": ["http://127.0.0.1:8000/mcp"]
}
}
}找到 mcp-proxy 的路径：
which mcp-proxy
Claude Desktop 将自动发现并对接所有 API 端点！?
总结
FastAPI-MCP 让你的 FastAPI 应用无缝集成 MCP 生态，只需一行代码，就能让 API 端点自动转换为 AI 代理工具可用的 MCP 工具，同时还保留 Swagger 文档。
适用于：
✅ 想让 FastAPI 自动暴露 API 的开发者
✅ 需要与 AI 代理（Claude / Cursor）交互 的场景
✅ 希望 零配置 即可对接 MCP 生态的项目
