Kolada MCP Server

Kolada MCP サーバー

スウェーデンのKolada自治体統計API向けの、シンプルでスタンドアロンなMCP（Model Context Protocol）サーバーです。

概要

このサーバーを使うと、AIアプリケーションからスウェーデンの包括的な自治体・地域統計データベースにアクセスできます。スウェーデンの公共部門データのさまざまな側面を網羅する数千件の主要業績評価指標（KPI）に対して、自然言語で問い合わせることができます。

特長

• 9つのMCPツールで包括的なデータにアクセス
• セマンティック検索にスウェーデン語BERT埋め込みを使用
• 外部依存関係なし — 完全にスタンドアロン（MimaもRedisも不要）
• Docker対応のコンテナ化
• 型ヒントとasync/awaitを備えた最新のPython 3.11以降

利用可能なツール

ツール	説明
list_operating_areas	KPIカテゴリの一覧と件数を取得
get_kpis_by_operating_area	特定のカテゴリに含まれるKPIを取得
search_kpis	自然言語でKPIをセマンティック検索
get_kpi_metadata	特定のKPIの詳細なメタデータを取得
fetch_kolada_data	自治体のKPI生データを取得
analyze_kpi_across_municipalities	ランキングを含む比較分析を実行
compare_kpis	2つのKPIを比較（差または相関）
list_municipalities	自治体・地域の一覧を取得
filter_municipalities_by_kpi	KPIのしきい値で絞り込み

インストール

pipを使用する場合

pip install -e .

Dockerを使用する場合

docker-compose up -d kolada-mcp

使用方法

Stdioモード（デフォルト）

kolada-mcp
# or
python -m kolada_mcp

HTTPモード

MCP_TRANSPORT=http PORT=8001 kolada-mcp

Claude Desktopとの連携

Claude Desktopの設定に追加します。

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

設定

環境変数：

変数	デフォルト	説明
MCP_TRANSPORT	stdio	トランスポートモード（stdioまたはhttp）
PORT	8001	HTTPサーバーのポート
LOG_LEVEL	INFO	ログレベル

開発

セットアップ

# 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

ライセンス

Apache-2.0