SuperAPI AI 工具集

apiverket-mcp

Apiverket MCP Server 是一个基于 Model Context Protocol(MCP)的服务器,让 AI 助手能够通过 Apiverket API 查询瑞典公共数据。它兼容 Claude Code、Claude Desktop、Cursor、VS Code、Gemini CLI 风格的 MCP 客户端及其他支持 MCP 的工具。该服务器在本地通过 stdio 运行,提供 govdata_discover、govdata_account 和 govdata_query 等工具,帮助代理发现并查询交通、天气、地理、市政、就业、政府、文化、教育、旅游、环境及公司数据等端点。使用需要 Apiverket API 密钥,或使用 sk_test_demo 进行沙盒设置。

访问官网

工具介绍

Apiverket MCP Server 是一个 MCP(Model Context Protocol)服务器,为 AI 助手提供通过 Apiverket API 访问瑞典公共数据的能力。它可与 Claude Code、Claude Desktop、Cursor、VS Code、Gemini CLI 风格的 MCP 客户端以及其他兼容 MCP 的工具配合使用。

用途 该服务器旨在让 AI 代理能够查询瑞典政府公开数据,涵盖公司数据、SCB 统计、天气、交通等多个领域。代理应通过结构化的工作流程发现和查询数据,而不是猜测 API 路径。

主要能力

  • 提供 govdata_discover 工具,用于根据用户主题搜索内置端点目录,无需 API 调用。
  • 提供 govdata_account 工具,用于查询配额、层级和生产就绪状态。
  • 提供 govdata_query 工具,仅使用发现返回的受支持端点调用 Apiverket API。
  • 发现功能包含交通、天气、地理、市政、就业、政府、文化、教育、旅游、环境和公司数据等系列工作流程,解释搜索/列表/详情模式、所需代码、坐标、日期格式、分页和常见恢复步骤。
  • 结构化 API 错误会转换为代理的恢复指导。
  • 大型响应会被截断并提供分页指导。

使用方式 代理应遵循以下步骤:

  1. 发现:使用用户主题调用 govdata_discover,而不是猜测路径。
  2. 检查上下文:针对配额、层级和生产就绪问题调用 govdata_account。
  3. 查询:仅使用发现返回的受支持端点调用 govdata_query。
  4. 恢复:如果请求失败,在重试前使用结构化恢复指导。

公司数据使用:

  • 使用 govdata_discover(query: "company") 查找受支持的公司端点。
  • 当用户只有公司名称或不确定组织编号时,使用 /v1/companies/search。
  • 缓存返回的 org_number。
  • 对于重复的丰富和自动化,使用 /v1/companies/{orgNumber}。
  • 如果公司搜索返回 429,在 reset_at 之前停止重试;当组织编号已知时使用查找。

密钥与限制 sk_test_demo 用于设置和安全沙盒响应,适合检查 MCP 客户端是否正确连接,但生产工作流应使用实时密钥。免费实时密钥适合探索;当每日 API 或公司搜索限制阻碍实际工作流时,可升级。公司搜索和实时公司查找按层级有单独的每日配额上下文。govdata_account 显示配置的密钥层级、剩余公司搜索配额、剩余公司查找配额、重置时间和可用升级层级。Apiverket 不通过公司 API 暴露公司董事会、高管、所有者或 UBO 子资源路径。

从源码构建 MCP 服务器在本地通过 stdio 运行。需要 Apiverket API 密钥,或使用 sk_test_demo 进行沙盒设置。

适用场景 适用于需要查询瑞典公共数据的 AI 助手工作流,包括公司信息查询、统计数据获取、天气和交通信息等。

限制

  • 需要 Apiverket API 密钥,或使用 sk_test_demo 进行沙盒测试。
  • 公司 API 不提供董事会、高管、所有者或 UBO 子资源路径。
  • 免费实时密钥有每日 API 或公司搜索限制。
  • 公司搜索和公司查找有独立的每日配额。
  • 大型响应会被截断。
  • 具体安装命令和配置细节暂未提供。