Kolada MCP Server

A clean, standalone MCP (Model Context Protocol) server for Sweden's Kolada municipal statistics API.

Overview

This server provides AI applications with access to Sweden's comprehensive municipal and regional statistics database. It enables natural language queries against thousands of Key Performance Indicators (KPIs) covering various aspects of Swedish public sector data.

Features

• 9 MCP Tools for comprehensive data access
• Semantic Search using Swedish BERT embeddings
• No External Dependencies - fully standalone (no Mima or Redis)
• Containerized with Docker support
• Modern Python 3.11+ with type hints and async/await

Available Tools

Installation

Using pip

pip install -e .

Using Docker

docker-compose up -d kolada-mcp

Usage

Stdio Mode (Default)

kolada-mcp
# or
python -m kolada_mcp

HTTP Mode

MCP_TRANSPORT=http PORT=8001 kolada-mcp

Claude Desktop Integration

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "kolada": {
      "command": "kolada-mcp"
    }
  }
}

Configuration

Environment variables:

Development

Setup

# Create virtual environment
python -m venv .venv
source .venv/bin/activate

# Install with dev dependencies
pip install -e ".[dev]"

Running Tests

pytest

Code Quality

# Linting
ruff check src tests

# Type checking
mypy src

Architecture

src/kolada_mcp/
├── __init__.py          # Package init
├── __main__.py          # Entry point
├── config.py            # Settings (Pydantic)
├── server.py            # FastMCP server
├── models/
│   └── types.py         # Data models
├── services/
│   ├── kolada_client.py # API client
│   ├── embeddings.py    # Semantic search
│   └── data_processing.py
└── tools/
    ├── metadata.py      # KPI metadata tools
    ├── data.py          # Data fetching tools
    ├── municipality.py  # Municipality tools
    └── comparison.py    # Comparison tools

License

Apache-2.0