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 错误会转换为代理的恢复指导。
- 大型响应会被截断并提供分页指导。
使用方式 代理应遵循以下步骤:
- 发现:使用用户主题调用 govdata_discover,而不是猜测路径。
- 检查上下文:针对配额、层级和生产就绪问题调用 govdata_account。
- 查询:仅使用发现返回的受支持端点调用 govdata_query。
- 恢复:如果请求失败,在重试前使用结构化恢复指导。
公司数据使用:
- 使用 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 或公司搜索限制。
- 公司搜索和公司查找有独立的每日配额。
- 大型响应会被截断。
- 具体安装命令和配置细节暂未提供。