mensa-stw-vp-mcp

# Mensa MCP Server An MCP (Model Context Protocol) server for accessing meal plans from Studierendenwerk Vorderpfalz (stw-vp.de). ## Features - Get meals plans for specific weeks or dates - Fetch meal plans for all canteens from Studierendenwerk Vorderpfalz - Structured JSON output with meal details (vegan, vegetarian, main dish flags) ## Available Canteens | ID | Name | | --- | ----------------- | | 310 | Landau | | 311 | Landau Bürgerstr. | | 320 | Germersheim | | 330 | Worms | | 340 | Ludwigshafen | ## Installation ```bash uv sync ``` ## Transports The server supports three transport protocols: - **stdio** (default) — launched as a child process by the MCP client. Best for IDE/editor integration. - **streamable-http** — runs as a long-running HTTP server. Best for remote access or multi-client deployments. - **sse** — runs the legacy HTTP+SSE transport for clients that still require it. ### Stdio (default) Add to your MCP client e.g., `opencode.json`: ```json { "mcpServers": { "mensa": { "type": "local", "command": ["uv", "run", "mensa-mcp", "--canteen", "330"], "cwd": "/Users/boza/git/hswo/zd/mensa-stw-vp" } } } ``` ### Streamable HTTP ```bash uv run mensa-mcp --transport streamable-http --port 8000 ``` The MCP endpoint is `/mcp`. ### SSE ```bash uv run mensa-mcp --transport sse --port 8000 ``` The default SSE endpoint is `/sse`, with client messages sent to `/messages/`. The `--canteen` argument sets the default canteen ID. Omit it if you prefer to always specify canteen_id explicitly. ## Available Tools ### list_canteens List all available canteens with their IDs and names. Parameters: none. Example: - `list_canteens()` ### get_weekly_meals Fetch the weekly meal plan for a canteen. Parameters: - canteen_id (int, optional): ID of the canteen (310, 311, 320, 330, 340). Uses default from command line if not specified. - week_number (int, optional): ISO wee…