Kolada MCP Server

Kolada MCP 服务

一个简洁、独立的 MCP（Model Context Protocol）服务，用于访问瑞典 Kolada 市政统计 API。

概述

此服务为 AI 应用提供访问瑞典综合市政和区域统计数据库的能力。它支持通过自然语言查询数千项关键绩效指标（KPI），涵盖瑞典公共部门数据的各个方面。

功能

• 9 个 MCP 工具，全面访问数据
• 语义搜索，使用瑞典语 BERT 嵌入
• 无外部依赖——完全独立（无需 Mima 或 Redis）
• 容器化，支持 Docker
• 现代化 Python 3.11+，使用类型提示和 async/await

可用工具

工具	描述
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	比较两项 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