FastAPI → FastMCP → Claude Desktop

This guide shows how to convert an existing FastAPI app into a FastMCP server so you can connect clients like Claude Desktop.

1️⃣ Install Dependencies

pip install fastmcp fastapi uvicorn

Make sure your FastAPI project is ready, e.g., main.py contains your app.

2️⃣ Create MCP Server Wrapper (MCPServer.py)

from fastmcp import FastMCP
from main import app  # Import your FastAPI app

# Convert FastAPI app into a FastMCP server
mcp = FastMCP.from_fastapi(
    app=app,
    name="Expense Tracker Server with FastAPI"
)

if __name__ == "__main__":
    # Start MCP server locally
    mcp.run()

3️⃣ Run Server Locally

# Development mode (hot reload)
uv run fastmcp dev MCPServer.py

# Normal run
uv run fastmcp run MCPServer.py

Server will run on http://0.0.0.0:8000 by default.

4️⃣ Connect Claude Desktop via Proxy

# Start proxy for remote connection
uv run fastmcp install claude-desktop proxyfile.py

5️⃣ FastMCP Cloud Deployment

1. Sign in at FastMCP Cloud.
2. Upload MCPServer.py as a new project.
3. Set project Public (open access) or Private (requires API token).
4. Use the /mcp URL for proxy connections to clients like Claude.

✅ Now your FastAPI app is MCP-enabled, ready for Claude integration, local development, or FastMCP cloud deployment.