FastAPI MCP工具

特性

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

# Your FastAPI app
app = FastAPI()

# Mount the MCP server to your app
add_mcp_server(
    app,                    # Your FastAPI app
    mount_path="/mcp",      # Where to mount the MCP server
    name="My API MCP",      # Name for the MCP server
)

就这样！你的自动生成的 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,                                    # Your FastAPI app
    mount_path="/mcp",                      # Where to mount the MCP server
    name="My API MCP",                      # Name for the MCP server
    describe_all_responses=True,            # False by default. Include all possible response schemas in tool descriptions, instead of just the successful response.
    describe_full_response_schema=True      # False by default. Include full JSON schema in tool descriptions, instead of just an LLM-friendly response example.
)

# Optionally add custom tools in addition to existing APIs.
@mcp_server.tool()
async def get_server_time() -> str:
    """Get the current server time."""
    from datetime import datetime
    return datetime.now().isoformat()

示例

请参阅 examples 目录中的完整示例。

使用 SSE 连接到 MCP 服务器

一旦你的带有 MCP 集成的 FastAPI 应用程序运行起来，你可以使用任何支持 SSE 的 MCP 客户端（如 Cursor）连接到它：

1. 运行你的应用程序。

2. 在 Cursor -> 设置 -> MCP 中，使用你的 MCP 服务器端点的 URL（例如 http://localhost:8000/mcp）作为 sse。

3. Cursor 将自动发现所有可用的工具和资源。

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

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

1. 运行你的应用程序。

2. 安装 mcp-proxy，例如：uv tool install mcp-proxy。

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

通过在终端中运行 which mcp-proxy 来找到 mcp-proxy 的路径。

1. Claude Desktop 会自动发现所有可用的工具和资源

开发与贡献

感谢您考虑为 FastAPI-MCP 开源项目做出贡献！正是像您这样的人让我们的社区用户能够真正使用这些项目。

在开始之前，请参阅 CONTRIBUTING.md。

社区

加入 MCParty Slack 社区，与其他 MCP 爱好者联系，提问并分享您使用 FastAPI-MCP 的经验。

要求

• Python 3.10+
• uv

许可证

MIT 许可证。版权所有 (c) 2024 Tadata Inc.

关于

由 Tadata Inc. 开发和维护