MCP BMI Server Template (FastAPI + SSE)

A minimal Model Context Protocol (MCP) server exposing a single tool: bmiCalculator.

• Discovery endpoint (SSE): GET /mcp
• Invocation endpoint: POST /invoke
• Health check: GET /healthz

Quick Start (local)

pip install -r requirements.txt
export API_KEY=changeme   # optional
uvicorn main:app --host 0.0.0.0 --port 10000

Test:

# Discover tools (SSE)
curl -N -H "Accept: text/event-stream" -H "x-api-key: changeme" http://localhost:10000/mcp

# Invoke tool
curl -X POST http://localhost:10000/invoke \
  -H "Content-Type: application/json" \
  -H "x-api-key: changeme" \
  -d '{"tool":"bmiCalculator","params":{"weight":70,"height":175,"unit":"cm"}}'

Docker

docker build -t mcp-bmi .
docker run -p 10000:10000 -e API_KEY=changeme mcp-bmi

Deploy to Render (example)

• Create a new Web Service from this repo
• Set environment variable API_KEY (optional but recommended)
• The service will start with the Dockerfile

Your base URL will look like:

https://<your-service>.onrender.com

Use the MCP SSE endpoint:

https://<your-service>.onrender.com/mcp

MCP Host config example

{
  "mcpServers": {
    "bmiAgent": {
      "url": "https://<your-service>.onrender.com/mcp",
      "headers": {
        "x-api-key": "changeme"
      }
    }
  }
}

Project structure

.
├── main.py
├── requirements.txt
├── Dockerfile
├── .gitignore
└── README.md

Notes

• SSE (text/event-stream) is used for discovery. If your host requires WebSocket, add a /ws endpoint.
• Extend by adding more tools in MCPHello.tools and dispatching in /invoke.