mcp-csu

# mcp-csu MCP server for the [Czech Statistical Office](https://www.czso.cz/) (ČSÚ / CZSO) [DataStat API](https://data.csu.gov.cz/). Gives AI assistants direct access to 700+ statistical datasets about the Czech Republic — population, economy, prices, wages, employment, industry, agriculture, trade, tourism, environment, and more. Single Python file. No cloning required — just `uvx mcp-csu`. ## Features - **Full catalog access** — search, browse, and inspect all 700+ datasets and 1500+ predefined tables - **Data retrieval** — fetch statistical data as CSV, query individual values with full context - **AI-optimized output** — human-readable text for metadata, CSV for data, automatic truncation with row counts - **Rate limiting** — built-in concurrency control (3 parallel requests) and minimum request interval (150ms) - **Caching** — catalog listings cached in memory for 10 minutes to avoid redundant requests - **No authentication** — the DataStat API is public ## Prerequisites - [uv](https://docs.astral.sh/uv/) (Python package runner) That's it. Python and all dependencies are managed automatically by `uv`. ## Configuration ### Claude Code Add to `~/.claude/settings.json`: ```json { "mcpServers": { "csu": { "command": "uvx", "args": ["mcp-csu"] } } } ``` ### Claude Desktop Add to `claude_desktop_config.json`: ```json { "mcpServers": { "csu": { "command": "uvx", "args": ["mcp-csu"] } } } ``` ### Any MCP client The server uses **stdio** transport (default). Launch command: ``` uvx mcp-csu ``` ## Data model The DataStat database has a hierarchical structure: ``` Dataset (sada) e.g. CEN0101H — "Míra inflace" ├── Dimensions (dimenze) e.g. CasR (years), Uz0 (territory) │ └── Items (položky) e.g. "2024", "CZ" ├── Indicators (ukazatele) e.g. 6134J06 — "Průměrná roční míra inflace" └── Selections (výběry) e.g. CEN0101HT01 — "Průměrná roční míra inflace" └── CSV data …