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.