MCP FastAPI Application Template

🌏 中文 | English

This project provides an MCP application template integrated with FastAPI.

• Support for multiple MCP mounting
• Support for command-line invocation in Stdio mode
• Support for SSE / StreamableHTTP / WebSocket
• Support for packaging and distribution

Starting from v0.1.2, we use BetterFastMCP to replace FastMCP, providing more comprehensive features than the official FastMCP:

• Support for Pydantic models as input parameters, enabling more complex input parameter types and convenient description addition
• Support for WebSocket as transport layer, access by /{mcp_name}/websocket/ws

Getting Started

Install dependencies:

uv sync

Development:

uv run dev

You can access the example MCP interface (Streamable HTTP) via http://127.0.0.1:3001/math/mcp, or access the SSE interface via http://127.0.0.1:3001/math/compatible/sse.

Call via command line with --stdio:

uv run prod --stdio

Deployment

Production:

uv run --no-sync prod

Build Python Wheel package:

uv build

Docker Deployment

Run:

docker compose up -d

Build only:

docker compose build