Kolada MCP 服务器

问题：过去五年，瑞典的幼儿园质量提升幅度最大的是哪里？

https://github.com/user-attachments/assets/b44317aa-4280-4be4-b64a-33b9feacc134

对 Kolada 数据进行 10 分钟分析后的最终结果。

注意： 本项目是一个独立的第三方实现，未获得 RKA（市政分析促进委员会）的认可或与其有关联。

Kolada MCP 服务器 实现了大型语言模型 (LLM) 与瑞典全面的市政和区域统计数据库 Kolada 之间的无缝集成。它提供了对数千个关键绩效指标 (KPI) 的结构化访问，从而促进了对公共部门统计数据的丰富、数据驱动的分析、比较和探索。

概述

Kolada MCP 服务器充当基于 LLM 的应用程序和 Kolada 数据库之间的智能中间件，允许用户轻松查询和分析与瑞典市政当局和地区相关的数据。凭借语义搜索功能和强大的分析工具，Kolada MCP 服务器大大简化了导航和解释 Kolada 中大量 KPI 的任务。

使用示例

尝试向 Kolada MCP 服务器提出需要自主推理和数据分析的开放性问题，例如：

• 在瑞典，一个家庭应该搬到哪里才能找到经济适用房、好学校和良好的医疗保健？
• 调查韦斯特诺兰省的失业与精神疾病之间的联系
• 过去五年，瑞典的幼儿园满意度提升幅度最大的是哪里？
• 准备一个交互式仪表板，以可视化瑞典公共交通系统最好和最差的城市（人口超过 25,000 的城市）的特征。

特性

• 语义搜索：根据自然语言描述查找 KPI。
• 类别过滤：访问按主题类别分组的 KPI（例如，人口统计、经济、教育）。
• 市政和区域数据检索：获取精确的数据点或历史时间序列。
• 多年比较分析：计算多年来所有市政当局、地区或省份的 KPI 绩效变化。
• 跨 KPI 关联：分析不同市政当局或地区之间不同 KPI 之间的关系。

组件

工具

1. list_operating_areas

   • 检索可用的 KPI 类别。

2. get_kpis_by_operating_area

   • 列出特定类别下的 KPI。

3. search_kpis

   • 执行语义搜索以发现相关的 KPI。

4. get_kpi_metadata

   • 访问特定 KPI 的详细元数据。

5. fetch_kolada_data

   • 获取特定市政当局或地区的精确 KPI 值。

6. analyze_kpi_across_municipalities

   • 对各个城市 KPI 的表现进行深入分析和比较。

7. compare_kpis

   • 评估两个 KPI 之间的相关性或差异。

8. list_municipalities

   • 返回按类型过滤的城市 ID 和名称列表（默认为 "K"）。为 municipality_type 传递一个空字符串将返回所有类型的城市。

快速开始

Kolada MCP 服务器使用合理的默认设置，在启动时获取数据并进行缓存。 使用 Kolada 的开放 API 不需要额外的 API 密钥或身份验证。

缓存

Kolada 还提供了一个预缓存的数据集，其中列出了所有可用的 KPI 及其元数据。 要使用新的缓存，只需删除 kpi_embeddings.npz 文件并重新启动服务器。

安装

强烈建议使用 uv 安装 Kolada MCP 的依赖项。 这确保所有依赖项都安装在一个干净的环境中。 只需运行 uv sync 即可安装所需的软件包。

开发和测试

在开发模式下，使用详细的调试功能在本地运行 Kolada MCP 服务器：

uv run mcp dev kolada-mcp.py

然后在浏览器中打开 MCP Inspector，地址为 http://localhost:5173。 使用 Inspector 界面可以：

• 测试单个工具。
• 检查返回的数据。
• 调试服务器交互。

Claude Desktop

要将 Kolada MCP 服务器添加到 Claude Desktop，请按照以下步骤操作：

1. 打开 claude_desktop_config.json 配置文件。 可以通过在 Claude Desktop 中打开设置，导航到“开发者”选项卡并单击“配置”按钮来找到它。
2. 将以下配置添加到 mcpServers 部分：

{
  "mcpServers": {
        "Kolada": {
        "command": "uv",
        "args": [
            "--directory",
            "[kolada-mcp 目录的路径]/src",
            "run",
            "server.py"
        ]
        }
    }
}

重启 Claude Desktop 以使用 Kolada MCP 服务器工具。

贡献

欢迎大家贡献！ 在 GitHub 上报告问题、提出改进建议或提交拉取请求。

免责声明

Kolada MCP 服务器是独立开发和维护的。 它未获得 "Rådet för främjande av kommunala analyser" (RKA) 或任何其他组织的正式认可、关联或相关。

许可证

Kolada MCP 服务器是在 Apache License 2.0 下发布的。