Kolada MCP Server

Kolada MCP 服务

用于通过 Kolada API 获取瑞典市政和地区统计数据的 MCP 服务。

LLM 可通过本地安装连接 Kolada MCP 服务，从而直接访问瑞典所有市政和地区的 **5,000 多项关键绩效指标（KPI）**数据和统计信息，涵盖 264 个领域（例如学校、医疗、环境、经济、民主等）。由 Isak Skogstad 开发，与 Kolada/RKA 无关。

English: Kolada MCP Server connects LLMs and AI chatbots to 5,000+ Key Performance Indicators (KPIs) across 264 operating areas for all 290 Swedish municipalities and 21 regions. Kolada is Sweden's most comprehensive open data source for municipal and regional statistics. Developed by Isak Skogstad, not associated with 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 助手优化

安全 / Security

Kolada MCP Server 使用多层自动安全扫描，确保代码完整性并检测漏洞：

🛡️ 自动安全工具

• CodeQL：持续进行代码分析，以查找安全缺陷
• GitGuardian：扫描是否存在暴露的 API 密钥和机密
• TruffleHog：在提交历史中进行补充性的机密扫描
• Bearer SAST：针对应用程序漏洞的静态应用安全测试
• Dependabot：自动安全更新依赖项
• npm audit：每日检查存在漏洞的软件包

📋 安全政策

请参阅 SECURITY.md，了解：

• 如何报告安全问题
• 安全扫描流程的详情
• 安全使用指南
• 联系信息

🔒 最佳实践

• 源代码中不包含硬编码的机密
• 所有敏感值均通过环境变量处理
• 配置速率限制和超时
• 定期自动进行安全更新

English：有关安全政策和漏洞报告，请参阅 SECURITY.md。

许可证

MIT – 请参阅 LICENSE

由 Isak Skogstad 创建。

Kolada 使用条款

• 使用 Kolada API 中的数据无需付费，也无需签订协议。
• 如果您在某项服务中使用 Kolada 的数据，必须注明来源（“来源：Kolada”）。
• 如果您对我们的数据进行了自行处理，则不得将 Kolada 标注为来源。
• 允许将我们的数据用于商业目的。
• 不得使用 API 传播恶意代码。
• 不得将您开发的服务宣传为与 RKA/Kolada 的“官方合作”或“合作伙伴关系”。
• 本服务按现状提供。
• Kolada 的数据会在全年持续发布，发布时间遵循各统计数据来源的发布时间。
• Kolada 中的数据可能会修订，且不会另行通知。
• 个别指标可能会从 Kolada 中移除，例如由于指标的数据基础发生变化；对此不会另行通知。