# DevHelm MCP Server

A public, stateless MCP server for demoing [mcp-recorder](https://github.com/devhelmhq/mcp-recorder) — record, replay, and verify MCP interactions with zero setup.

**Live:** `https://mcp.devhelm.io/mcp`

## Try It

```bash
mcp-recorder record  --target https://mcp.devhelm.io/mcp --output demo.json
mcp-recorder replay  --cassette demo.json
mcp-recorder verify  --cassette demo.json --target https://mcp.devhelm.io/mcp
```

## Run Locally

```bash
uv sync
uv run python -m devhelm_mcp.server
```

The server starts at `http://localhost:8000/mcp`. Health check at `http://localhost:8000/health`.

## Tools

| Tool | Parameters | Returns |
|------|-----------|---------|
| `add` | `a: int, b: int` | `int` — the sum |
| `greet` | `name: str, style: str = "friendly"` | `str` — greeting (friendly / formal / pirate) |
| `lookup_status` | `service: str` | `dict` — status for api, database, or unknown |
| `summarize` | `text: str, max_words: int = 20` | `str` — truncated text |
| `roll_dice` | `sides: int = 6, count: int = 1` | `dict` — `{"rolls": [...], "total": N}` |

## Resources

| URI | Returns |
|-----|---------|
| `resource://server-info` | Server name, version, description |
| `resource://tools-guide` | Markdown reference for all tools |

## Deploy

```bash
docker compose up -d --build
```

Uses Caddy for automatic HTTPS. See `docker-compose.yml` and `Caddyfile`.