Kolada MCP Server

Kolada MCP サーバー

Kolada API のスウェーデンの自治体・地域統計を提供する MCP サーバーです。

Kolada MCP サーバーをローカルにインストールすると、LLM を接続して、スウェーデンのすべての自治体と地域に関する 264 の分野（学校、医療、環境、経済、民主主義など）の 5,000 以上の指標（KPI） のデータと統計に直接アクセスできます。Isak Skogstad が開発したもので、Kolada/RKA とは独立しています。

英語： Kolada MCP Server は、290 のスウェーデンの自治体と 21 の地域すべてを対象に、264 の事業分野にわたる 5,000 以上の主要業績評価指標（KPI）に、LLM や AI チャットボットがアクセスできるようにします。Kolada は、自治体・地域統計を扱うスウェーデン最大のオープンデータソースです。Isak Skogstad が開発したもので、Kolada/SKR とは関係ありません。

https://github.com/user-attachments/assets/6791bb81-79dc-4af3-8028-44c3929d57d0

インストール

npx を使用（最速）：

npx kolada-mcp-server

グローバルインストールを使用：

npm install -g kolada-mcp-server
kolada-mcp-server

パッケージは npm で公開されています：kolada-mcp-server。

クライアントの設定

Claude Desktop

設定ファイルに追加します：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kolada": {
      "command": "npx",
      "args": ["-y", "kolada-mcp-server"]
    }
  }
}

Claude Code（CLI）

claude mcp add kolada -- npx -y kolada-mcp-server

次のコマンドで確認します：

claude mcp list

OpenAI Codex CLI

~/.codex/config.toml に追加します：

[mcp_servers.kolada]
command = "npx"
args = ["-y", "kolada-mcp-server"]

Gemini CLI

~/.gemini/settings.json に追加します：

{
  "mcpServers": {
    "kolada": {
      "command": "npx",
      "args": ["-y", "kolada-mcp-server"]
    }
  }
}

Firebase Studio / Android Studio

プロジェクトのルートにある mcp.json に追加します：

{
  "mcpServers": {
    "kolada": {
      "command": "npx",
      "args": ["-y", "kolada-mcp-server"]
    }
  }
}

その他の MCP クライアント

ほとんどの MCP クライアントは stdio トランスポートに対応しています。次の設定を使用してください：

{
  "mcpServers": {
    "kolada": {
      "command": "npx",
      "args": ["-y", "kolada-mcp-server"]
    }
  }
}

ソースからインストール

git clone https://github.com/isakskogstad/kolada-mcp.git
cd kolada-mcp
npm install
npm run build
node dist/index.js

ツール

指標（KPI）

ツール	説明
search_kpis	5,000 以上の指標を全文検索
get_kpi	ID で指標のメタデータを取得
get_kpis	複数の指標をまとめて取得（最大 25 件）
get_kpi_groups	テーマ別グループの一覧を取得
get_kpi_group	グループ内のすべての指標を取得
list_operating_areas	264 の事業分野の一覧を取得
get_kpis_by_operating_area	事業分野ごとに指標を絞り込み

自治体と地域

ツール	説明
search_municipalities	290 の自治体と 21 の地域を検索
get_municipality	自治体 ID（例：「0180」）で詳細を取得
get_municipality_groups	自治体グループの一覧を取得
get_municipality_group	グループ内の自治体を取得

組織単位

ツール	説明
search_organizational_units	学校、介護施設などを検索
get_organizational_unit	組織単位の詳細を取得
get_ou_types	単位の種類の一覧を取得

データ

ツール	説明
get_kpi_data	性別フィルター（T/M/K）を適用して値を取得
get_municipality_kpis	自治体の KPI を一覧表示
compare_municipalities	2～10 の自治体を比較
get_kpi_trend	時系列分析

分析

ツール	説明
analyze_kpi_across_municipalities	統計 + ランキング
filter_municipalities_by_kpi	しきい値で絞り込み
compare_kpis	指標間の相関

事業分野（抜粋）

分野	KPI 数
自治体全般	553
基礎学校 0～9 年生	470
高等学校 1～3 年生	215
医療・保健	204
人口	199
地域／県	151
就学前教育	135
成人教育	126

事業分野は合計 264 あります。

施設の種類

コード	種類
V11	就学前施設
V15	基礎学校
V16	高等学校
V17	特別支援学校
V18	成人教育
V21	高齢者施設
V31	学童保育施設

主な機能

• 性別フィルター – T（合計）、M（男性）、K（女性）
• スマートキャッシュ – カタログを 24 時間キャッシュします
• レート制限 – Kolada API の制限を遵守します
• スウェーデン語のドキュメント – スウェーデン語の AI アシスタント向けに最適化されています

セキュリティ / セキュリティ

Kolada MCP Server は、コードの整合性を確保し、脆弱性を検出するために、複数層の自動セキュリティスキャンを実施しています。

🛡️ 自動セキュリティツール

• CodeQL: セキュリティ上の問題を継続的にコード分析します
• GitGuardian: 公開された API キーやシークレットをスキャンします
• TruffleHog: コミット履歴を対象とした補完的なシークレットスキャン
• Bearer SAST: アプリケーションの脆弱性を対象とした静的アプリケーションセキュリティテスト
• Dependabot: 依存関係のセキュリティ更新を自動化します
• npm audit: 脆弱なパッケージを毎日確認します

📋 セキュリティポリシー

以下については SECURITY.md をご覧ください。

• セキュリティ上の問題を報告する方法
• セキュリティスキャンプロセスの詳細
• 安全に使用するためのガイドライン
• お問い合わせ先

🔒 ベストプラクティス

• ソースコードにシークレットをハードコードしません
• 機密性の高い値はすべて環境変数で管理します
• レート制限とタイムアウトを設定します
• セキュリティ更新を定期的に自動適用します

英語: セキュリティポリシーと脆弱性の報告については、SECURITY.md をご覧ください。

ライセンス

MIT – LICENSE をご覧ください

Isak Skogstad 作成。

Kolada 利用規約

• Kolada の API からデータを利用する際、料金はかからず、契約も必要ありません。
• Kolada のデータをサービスで利用する場合は、出典（「出典：Kolada」）を明記してください。
• データを独自に加工した場合、Kolada を出典として記載してはなりません。
• データは商用目的で利用できます。
• API を悪意のあるコードの拡散に使用してはなりません。
• 開発したサービスを、RKA/Kolada との「公式な協力」または「パートナーシップ」として提示してはなりません。
• 本サービスは現状有姿で提供されます。
• Kolada のデータは、各統計情報源の公開時期に従って年間を通じて随時公開されます。
• Kolada のデータは改訂される場合がありますが、個別に通知されることはありません。
• 指標の根拠となるデータの変更などを理由に、個々の指標が Kolada から削除される場合がありますが、事前に通知されることはありません。