MCP 服务器

FastAPI-MCP

一个零配置工具，可以自动将 FastAPI 端点暴露为模型上下文协议 (Model Context Protocol, MCP) 工具，从而允许像 Claude 这样的 LLM 系统与你的 API 交互，而无需额外的编码。

AI集成系统

README

<p align="center"><a href="https://github.com/tadata-org/fastapi_mcp"><img src="https://github.com/user-attachments/assets/609d5b8b-37a1-42c4-87e2-f045b60026b1" alt="fastapi-to-mcp" height="100"/></a></p> <h1 align="center">FastAPI-MCP</h1> <p align="center">一个零配置工具，用于自动将 FastAPI 端点公开为模型上下文协议 (MCP) 工具。</p> <div align="center">

</div>

特性

直接集成 - 将 MCP 服务器直接挂载到您的 FastAPI 应用程序
零配置 - 只需将其指向您的 FastAPI 应用程序即可工作
自动发现 所有 FastAPI 端点并转换为 MCP 工具
保留请求模型和响应模型的模式
保留文档 所有端点的文档，就像 Swagger 中一样
扩展 - 在自动生成的工具旁边添加自定义 MCP 工具

安装

我们建议使用 uv，一个快速的 Python 包安装程序：

uv add fastapi-mcp

或者，您可以使用 pip 安装：

pip install fastapi-mcp

基本用法

使用 FastAPI-MCP 最简单的方法是将 MCP 服务器直接添加到您的 FastAPI 应用程序：

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://app.base.url/mcp 上使用。

高级用法

FastAPI-MCP 提供了几种自定义和控制 MCP 服务器创建和配置方式的方法。以下是一些高级用法模式：

from fastapi import FastAPI
from fastapi_mcp import add_mcp_server

app = FastAPI()

mcp_server = add_mcp_server(
    app,                                    # 您的 FastAPI 应用程序
    mount_path="/mcp",                      # MCP 服务器的挂载位置
    name="My API MCP",      # MCP 服务器的名称
    describe_all_responses=True,            # 默认为 False。 在工具描述中包含所有可能的响应模式，而不仅仅是成功的响应。
    describe_full_response_schema=True      # 默认为 False。 在工具描述中包含完整的 JSON 模式，而不仅仅是 LLM 友好的响应示例。
)

# （可选）除了现有 API 之外，还可以添加自定义工具。
@mcp_server.tool()
async def get_server_time() -> str:
    """获取当前服务器时间。"""
    from datetime import datetime
    return datetime.now().isoformat()

示例

有关完整示例，请参见 examples 目录。

使用 SSE 连接到 MCP 服务器

一旦您的带有 MCP 集成的 FastAPI 应用程序正在运行，您可以使用任何支持 SSE 的 MCP 客户端连接到它，例如 Cursor：

运行您的应用程序。
在 Cursor -> Settings -> MCP 中，使用您的 MCP 服务器端点的 URL（例如，http://localhost:8000/mcp）作为 sse。
Cursor 将自动发现所有可用的工具和资源。

使用 mcp-proxy stdio 连接到 MCP 服务器

如果您的 MCP 客户端不支持 SSE，例如 Claude Desktop：

运行您的应用程序。
安装 mcp-proxy，例如：uv tool install mcp-proxy。
在 Claude Desktop MCP 配置文件 (claude_desktop_config.json) 中添加：

在 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"]
    }
  }
}