opendata-mcp — data.gov.ua MCP server

Українською

An open-source MCP server that lets any MCP-compatible AI agent search and analyze Ukraine's national open-data portal data.gov.ua in natural language.

It speaks the Model Context Protocol, so it works with any client that supports MCP — including Claude (Desktop / Code), ChatGPT (Developer Mode / custom connectors), Google Gemini, Cursor, Cline / Continue, VS Code Copilot, local models via Ollama / LM Studio, and your own agents built on the Python/TypeScript MCP SDKs. Not tied to any single vendor.

Phase 1: read-only, public endpoints — no API token, no auth required.

Design

Tools are jobs-to-be-done, not thin API wrappers. Each tool does a complete user task, composes several CKAN calls internally, hides portal quirks (UUID slugs, dirty formats, sparse DataStore, Unicode homoglyphs), and returns a token-efficient slim result (a search hit is ~150 B vs ~17 KB raw).

Tool	What it does
`find_datasets`	Find datasets by topic; ranked slim candidates + refine hints
`explore_catalog`	Aggregate view (who publishes / how much) — counts only
`inspect_dataset`	Full dataset card: license, freshness, resources
`get_dataset_data`	Get the actual data — auto-picks best resource; DataStore or download+parse CSV/JSON/XLSX/XML, including files inside ZIP archives (ЄДР, debtors registries)
`filter_data`	Filter rows / read-only SQL over a structured (DataStore) resource
`track_updates`	Recently updated datasets, filterable by topic/org

Install

The server runs over stdio, the transport every MCP client understands. The config below is the same everywhere — only the file/menu where you paste it differs per client.

Any MCP client (npm) — universal

{
  "mcpServers": {
    "opendata-ua": {
      "command": "npx",
      "args": ["-y", "@opendata-ua/mcp-server"]
    }
  }
}

Where to put it:

Client	Location
Claude Desktop	Settings → Developer → Edit Config (`claude_desktop_config.json`)
Claude Code	`claude mcp add opendata-ua -- npx -y @opendata-ua/mcp-server`
ChatGPT	Settings → Connectors → add MCP server (Developer Mode)
Google Gemini	Gemini CLI / SDK `mcpServers` config
Cursor	Settings → MCP → Add Server (`~/.cursor/mcp.json`)
Cline / Continue / VS Code	the extension's MCP settings
Custom agent	point your MCP SDK at `npx -y @opendata-ua/mcp-server`

Claude Desktop — one-click DXT

DXT is Claude Desktop's drag-and-drop bundle format:

Download opendata-ua-mcp.dxt from Releases.
Drag it into Claude Desktop → Settings → Extensions. Done. No config.

From source

npm install
npm run build
node dist/stdio.js   # any MCP client can spawn this

Try it

"Find ecology datasets from Lviv published in 2024""Which organizations publish the most procurement data?""Show me the first rows of the stolen-vehicles register"

Configuration (optional)

Env var	Default	Purpose
`DATA_GOV_UA_BASE_URL`	`https://data.gov.ua/api/3/action`	API base (mirror/dev portal)
`CACHE_TTL_SECONDS`	`300`	LRU cache TTL for catalogs
`HTTP_TIMEOUT_MS`	`30000`	Request timeout
`MAX_RESPONSE_CHARS`	`60000`	Per-response context-budget ceiling
`MAX_DOWNLOAD_BYTES`	`10000000`	Cap for files downloaded + parsed locally
`LOG_LEVEL`	`info`	`debug`/`info`/`warn`/`error`

Develop

npm test          # vitest
npm run typecheck
npm run lint
npm run smoke      # live test against data.gov.ua
npm run build:dxt  # build the .dxt package

The portal runs CKAN 2.7.2. DataStore (queryable rows) covers only ~0.3 % of resources, so get_dataset_data downloads + parses files locally when needed; filter_data/SQL apply to the DataStore-active minority.

opendata-mcp — data.gov.ua MCP server