瑞典统计数据API服务

提供对瑞典统计数据的访问服务,包括就业、劳动力成本、工资等统计数据表的浏览、搜索和获取功能。

  • by ashwinvis
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ashwinvis/scb-opendata-mcp

使用说明

瑞典统计局MCP服务器(SCB)API

FastMCP服务器,提供对瑞典统计局PxWebApi v2的访问,提供涵盖瑞典就业、劳动力成本、工资和其他民事数据的统计表。

特性

  • 表发现:浏览和搜索5155个统计表
  • 数据检索:使用可选过滤获取统计数据
  • 代码列表:有效筛选值的访问代码列表
  • 保存的查询:保存和检索常用查询
  • 分页:高效处理大型结果集
  • 语言支持:英语和瑞典语
  • 错误处理:具有重试逻辑的强大错误处理

安装

先决条件

  • 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

通用代理线束的配置

克劳德代码

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

米斯特拉尔·维贝

在 ~/.vibe/config.toml 或 ~/.vibe/agents/name_of_agent.toml:

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

开源代码

在 ~/.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

贡献

欢迎投稿!请随时提交拉取请求。

许可证

MIT许可证

支持

对于问题或疑问:

SCB开放数据技能

这是一个非官方的配套存储库 SCB开放数据技能 它提供了通过此MCP服务器访问瑞典统计局数据的技能定义。这些技能旨在与主要的编码代理工具配合使用,并为各种统计领域提供工作流程。

免责声明

这是一个非官方工具。该代码是使用AI生成的,同时使用官方文件和API规范作为上下文。 还添加了测试来验证功能。建议在将其用于任何用途之前进行彻底严格的验证测试 认真应用。