pip install -e .

docker-compose up -d kolada-mcp

kolada-mcp
# or
python -m kolada_mcp

MCP_TRANSPORT=http PORT=8001 kolada-mcp

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

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

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

pytest

# Linting
ruff check src tests

# Type checking
mypy src

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