# 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)
```bash
pip install -r requirements.txt
export API_KEY=changeme # optional
uvicorn main:app --host 0.0.0.0 --port 10000
```
Test:
```bash
# 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
```bash
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
```json
{
"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`.
