README.md
A public, stateless MCP server for demoing mcp-recorder.
DevHelm MCP Server
A public, stateless MCP server for demoing mcp-recorder — record, replay, and verify MCP interactions with zero setup.
Live: https://mcp.devhelm.io/mcp
Try It
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
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
docker compose up -d --build
Uses Caddy for automatic HTTPS. See docker-compose.yml and Caddyfile.
Tools (5)
addCalculates the sum of two integers.greetProvides a greeting in a specified style.lookup_statusChecks the status for api, database, or unknown services.summarizeTruncates text to a specified word count.roll_diceRolls dice with a specified number of sides and count.Configuration
claude_desktop_config.json
{"mcpServers": {"devhelm": {"command": "uv", "args": ["run", "python", "-m", "devhelm_mcp.server"]}}}Try it
→Add 45 and 78 together.
→Greet me in a pirate style.
→Check the status of the database service.
→Summarize this text into 10 words: [insert text here].
→Roll 2 dice with 20 sides each.