golemio-mcp 0.1.1

MCP server exposing Prague's Golemio API for AI assistants

Golemio MCP Server

An MCP server that exposes Prague's Golemio open data API to AI assistants. Query public transit departures, air quality, parking availability, and more.

Setup

Get an API key from https://api.golemio.cz/api-keys/

Standard systems (macOS, Ubuntu, etc.)

Install uv if you haven't: curl -LsSf https://astral.sh/uv/install.sh | sh

Add to your MCP configuration (e.g., ~/.mcp.json):

{
  "mcpServers": {
    "golemio": {
      "command": "uv",
      "args": [
        "--directory", "/absolute/path/to/golemio-mcp-server",
        "run", "golemio_server.py"
      ],
      "env": {
        "GOLEMIO_API_KEY": "your-api-key"
      }
    }
  }
}

NixOS

On NixOS, uv needs to use the system Python to avoid dynamic linking issues:

{
  "mcpServers": {
    "golemio": {
      "command": "nix-shell",
      "args": [
        "-p", "uv",
        "--run", "UV_PYTHON=/run/current-system/sw/bin/python3 uv --directory /absolute/path/to/golemio-mcp-server run golemio_server.py"
      ],
      "env": {
        "GOLEMIO_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

Public Transit

• search_stops - Find stops by name (works with or without Czech diacritics)
• get_departures - Real-time departure boards

City Data

• get_air_quality_stations - Air quality measurements
• get_parking_lots - Parking availability
• get_waste_stations - Waste container fill levels
• get_bicycle_counters / get_bicycle_detections - Bike traffic data

Points of Interest

• get_medical_institutions - Hospitals, clinics
• get_municipal_libraries - Public libraries
• get_playgrounds - Playgrounds
• get_gardens - Public gardens
• get_city_districts - District boundaries

Development

Requires Python 3.12+ and uv.

# Install dependencies
uv sync

# Run tests
uv run pytest -v

# Run server
uv run golemio_server.py