MCP 服务器

Stravacz MCP Server

Provides tools to interact with the strava.cz meal ordering system, enabling users to view menus, check and place orders, and manage their canteen account.

README

Stravacz MCP Server

MCP (Model Context Protocol) server pro strava.cz - systém a webová/mobilní aplikace pro objednávání stravy v českých jídelnách, například školních. Strávníci mohou prostřednictvím systému kontrolovat jídelníčky, přihlašovat a odhlašovat jídlo, sledovat historii objednávek, platby a přeplatky.

</div>

⚠️ Upozornění

!! K používání tohoto projektu je potřeba trošku umět s dockerem/pythonem a vědět, jak funguje připojení MCP k danému LLM klientu !!

💡 Poznámka: Tento projekt není nijak spojen se systémem strava.cz. Jedná se o neoficiální MCP server vytvořený komunitou na základě projektů strava-cz-python a strava-cli.

⚡ Rychlý start

🐳 Docker (doporučeno)

# CLI (stdio) verze
docker run --rm -i ghcr.io/mirecekd/stravacz-mcp:latest-cli \
  --user USERNAME --password PASSWORD --canteen_number CANTEEN_NUMBER

# HTTP streaming verze (port 8809)
docker run -p 8809:8809 ghcr.io/mirecekd/stravacz-mcp:latest-http \
  --user USERNAME --password PASSWORD --canteen_number CANTEEN_NUMBER

📦 uvx (PyPI)

# Instalace z PyPI a spuštění
uvx --from stravacz-mcp stravacz-mcp-server \
  --user USERNAME --password PASSWORD --canteen_number CANTEEN_NUMBER

🔧 Dostupné transport metody

Stravacz MCP Server podporuje tři transport metody podle vzoru bakalari-mcp:

Transport	Port	Docker Image	Popis
CLI (stdio)	-	`ghcr.io/mirecekd/stravacz-mcp:latest-cli`	Přímá MCP komunikace přes stdin/stdout
HTTP Streaming	8809	`ghcr.io/mirecekd/stravacz-mcp:latest-http`	Nativní HTTP streaming transport
HTTP Proxy	8805	`ghcr.io/mirecekd/stravacz-mcp:latest-proxy`	HTTP server pomocí mcp-proxy

🛠️ MCP Tools

Server poskytuje následující nástroje pro práci se strava.cz:

`get_menu(datum=None)`

Získání jídelníčku pro zadané datum (YYYY-MM-DD) nebo dnešní datum.

`is_ordered(meal_id)`

Kontrola, jestli je jídlo s daným ID objednané.

`order_meals(*meal_ids)`

Objednání více jídel podle jejich ID.

`print_menu(include_soup=True, include_empty=False)`

Formátované vypsání menu s možností filtrace.

`get_user_info()`

Získání informací o přihlášeném uživateli a jídelně.

`logout()`

Odhlášení ze strava.cz systému.

📋 MCP konfigurace

Claude Desktop (CLI verze)

{
  "mcpServers": {
    "stravacz-mcp": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i", "ghcr.io/mirecekd/stravacz-mcp:latest-cli",
        "--user", "YOUR_USER",
        "--password", "YOUR_PASSWORD", 
        "--canteen_number", "YOUR_CANTEEN_NUMBER"
      ],
      "transportType": "stdio"
    }
  }
}

Claude Desktop (HTTP streaming)

{
  "mcpServers": {
    "stravacz-mcp": {
      "url": "http://localhost:8809",
      "transportType": "http"
    }
  }
}

🏗️ Vývoj a build

Lokální vývoj

# Klonování repositáře
git clone https://github.com/mirecekd/stravacz-mcp.git
cd stravacz-mcp

# Instalace závislostí
pip install -e .

# Spuštění ze zdrojových kódů
python src/stravacz_mcp_server/server.py --user USER --password PASS --canteen_number NUM

Docker build

# Build všech verzí
./build-all.sh

# Nebo jednotlivě
./build-cli.sh     # CLI verze
./build-http.sh    # HTTP streaming verze  
./build-proxy.sh   # HTTP proxy verze

Python packaging

# Build Python balíčku
python -m build

# Lokální instalace z wheel
pip install dist/stravacz_mcp-1.0.0-py3-none-any.whl

🔍 Technické detaily

Závislosti

strava-cz >= 1.0.0 - Hlavní knihovna pro strava.cz API
fastmcp >= 0.9.0 - MCP framework
aiohttp >= 3.8.0 - Async HTTP klient

Async wrapper

Server používá async wrapper pro původně synchronní strava-cz knihovnu pomocí asyncio.to_thread(), což umožňuje neblokující operace.

Multi-arch Docker images

Všechny Docker images podporují:

linux/amd64 (Intel/AMD x64)
linux/arm64 (Apple Silicon, ARM64)

⚠️ Důležité upozornění

Tento projekt používa neoficiální web scraping API pro strava.cz. Server může přestat fungovat při změnách na webu strava.cz. Používejte zodpovědně a neautomatizujte masivní množství požadavků.