scb-opendata-mcp

Statistics Sweden（SCB）API 的 MCP 服务

一个 FastMCP 服务，可访问 Statistics Sweden 的 PxWebApi v2，提供涵盖瑞典就业、劳动力成本、工资及其他民事数据的统计表。

功能

• 表格发现：浏览和搜索 5,155 个统计表
• 数据检索：获取统计数据，并可选择进行筛选
• 代码列表：获取有效筛选值的代码列表
• 已保存的查询：保存和检索常用查询
• 分页：高效处理大型结果集
• 语言支持：英语和瑞典语
• 错误处理：提供稳健的错误处理和重试逻辑

安装

前提条件

• Python 3.11 或更高版本
• pip 或 uv 包管理器

从 PyPI 安装

pip install scb-opendata-mcp

# Or with uv
uvx scb_opendata_mcp

从源代码安装

# Clone the repository
git clone https://github.com/ashwinvis/scb-opendata-mcp.git
cd scb-opendata-mcp

# Install dependencies
pip install .

# Or with uv
uv sync

用法

运行服务

安装后，该软件包

scb_opendata_mcp

# Or with uv
uv run scb_opendata_mcp

可通过 scb_opendata_mcp --help 查看可用选项。此外还支持 stdio 传输机制。

备用选项

uv run fastmcp run src/scb_opendata_mcp/server.py -t http  # HTTP server

常见 Agent 框架的配置

Claude Code

claude mcp add --scope user --transport http scb_opendata_mcp http://localhost:6767

Mistral Vibe

在 ~/.vibe/config.toml 或 ~/.vibe/agents/name_of_agent.toml 中：

[[mcp_servers]]
name = "scb_opendata_mcp"
transport = "http"
url = "http://localhost:6767/mcp"

OpenCode

在 ~/.config/opencode/opencode.jsonc 中：

{
  "mcp": {
    "scb_opendata_mcp": {
      "type": "remote",
      "url": "https://localhost:6767/mcp",
      "enabled": true
    }
  }
}

可用工具

表格发现

• list_tables() - 分页列出所有可用的统计表
• get_table_metadata(table_id) - 获取详细元数据，包括变量
• search_tables(query) - list_tables 的便捷封装，可按名称或描述搜索表格

数据检索

• get_table_data(table_id, filters) - 获取数据，并可选择进行筛选
• get_table_default_selection(table_id) - 获取表格的默认数据选取

代码列表工具

• list_codelists(table_id) - 列出表格所有可用的代码列表
• get_codelist(codelist_id) - 获取特定代码列表的详细信息

已保存查询工具

• get_saved_query(query_id) - 获取已保存的查询，包括数据和选取条件
• get_saved_query_data(query_id) - 获取特定已保存查询的数据
• get_saved_query_selection(query_id) - 获取特定已保存查询所使用的选取查询
• save_query(table_id, selection) - 保存数据查询
• delete_saved_query(query_id) - 删除已保存的查询

开发

运行测试

uv run pytest

贡献

欢迎贡献！欢迎提交 Pull Request。

许可证

MIT 许可证

支持

如有问题或疑问：

• 查看 OpenAPI 规范，或访问 https://github.com/PxTools/PxApiSpecs/blob/master/PxAPI-2.yml。
• 查看 Statistics Sweden API 文档：
  • 瑞典语：https://www.scb.se/vara-tjanster/oppna-data/pxwebapi/pxwebapi-v2/
  • 英语：https://www.scb.se/en/services/open-data-api/pxwebapi/

SCB Open Data Skills

这是一个非官方配套仓库 SCB Open Data Skills，提供通过此 MCP 服务访问 Statistics Sweden 数据的技能定义。这些技能旨在与主流编码 Agent 工具配合使用，并为各类统计领域提供工作流。

免责声明

这是一个非官方工具。代码是在使用官方文档和 API 规范作为上下文的情况下，通过 AI 生成的。 此外还添加了测试以验证其功能。建议在任何严肃的应用中使用前，进行全面严格的验证测试。