一行代码，让 FastAPI 应用秒变 MCP 服务器！

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. 1. 运行 FastAPI 应用
2. 2. 在 Cursor 设置中，填写 MCP 服务器 URL（如 http://localhost:8000/mcp）
3. 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 生态的项目