使用说明
Kolada MCP 服务器
Kolada MCP 服务器 实现了大型语言模型(LLMs)与(其他系统/服务)之间的无缝集成 Kolada(科拉达)瑞典的全面市政和区域统计数据库。它提供了对数千个关键绩效指标(KPI)的结构化访问,便于进行丰富、基于数据的分析、比较和探索公共部门统计数据。
概述
Kolada MCP服务器作为基于大型语言模型(LLM)的应用程序与Kolada数据库之间的智能中间件,使得查询和分析与瑞典市政当局和区域相关的数据变得轻松便捷。凭借其语义搜索功能和强大的分析工具,Kolada MCP极大地简化了在Kolada中浏览和解读海量关键绩效指标(KPIs)的过程。
示例查询
向Kolada MCP服务器提出需要数据分析的复杂问题:
- 在瑞典,一个家庭应该搬到哪里才能找到负担得起的住房、优质的学校和医疗服务?
- 调查韦斯特诺尔兰省失业与精神疾病之间的关联。
- 找出过去五年内幼儿教育质量提升幅度最大的市镇。
- 创建一个仪表板,展示公共交通最优和最差的市政区。
特点/功能
- 语义搜索针对关键绩效指标(KPIs)的自然语言查询。
- 类别过滤按主题领域访问关键绩效指标(KPIs)。
- 市级与区域数据检索获取KPI数据或历史时间序列。
- 多年度对比分析评估各市政区的KPI绩效变化。
- 跨KPI相关性分析关键绩效指标(KPIs)之间的关系。
可用工具
- 运营区域列表检索可用的KPI类别。
- **按运营区域获取KPIs(关键绩效指标)**列出某一类别下的关键绩效指标(KPIs)。
- **搜索关键绩效指标(KPIs)**使用语义搜索发现关键绩效指标(KPIs)。
- 获取KPI元数据访问详细的KPI元数据。
- 获取科拉达数据检索关键绩效指标(KPI)值。
- **跨市政区域分析KPI(关键绩效指标)**深入的市政关键绩效指标(KPI)分析。
- **比较关键绩效指标(KPIs)**评估关键绩效指标(KPI)之间的相关性。
- 市列表列出市政当局的ID和名称。
快速入门
Kolada MCP 服务器包含预缓存的 KPI 元数据。删除 kpi_embeddings.npz 刷新。
安装
使用 uv 安装Kolada MCP依赖项:
uv sync
本地运行以进行开发
MCP 开发(Claude 桌面版)
在本地启动服务器:
uv run mcp dev server.py
开放 MCP 检查员 在 http://localhost:5173 进行测试和调试。
HTTP服务器(集成ChatGPT)
启动用于集成ChatGPT的HTTP服务器:
uv run kolada-mcp-http
服务器将在 http://localhost:8000. 见 CHATGPT_SETUP.md(文件名,可译为“CHATGPT设置指南.md”或保持原样,具体取决于上下文和使用场景) 如需详细的ChatGPT集成指南,请参阅。
Claude 桌面集成
编辑你的 claude_desktop_config.json 添加Kolada MCP服务器:
Docker 镜像(本地构建)
"KoladaDocker": {
"args": [
"run",
"-i",
"--rm",
"--name",
"kolada-mcp-managed",
"kolada-mcp:local"
],
"command": "docker",
"env": {}
}
通过 PyPI 预构建的容器
"KoladaPyPI": {
"args": ["kolada-mcp"],
"command": "/Users/hugi/.cargo/bin/uvx"
}
本地UV执行(无需Docker)
替换 [path to kolada-mcp] 与您的本地目录:
"KoladaLocal": {
"args": [
"--directory",
"[path to kolada-mcp]/src/kolada_mcp",
"run",
"kolada-mcp"
],
"command": "uv"
}
更新后重启Claude桌面版。
做出贡献
欢迎贡献!请在GitHub上提交问题、增强功能或拉取请求(PRs)。
免责声明
Kolada MCP服务器是自主研发的,并非由RKA或其他组织认可或关联。
许可证
Kolada MCP 服务器遵循以下许可协议: Apache许可证2.0。
