Openswissdata

@openswissdata/mcp

用于瑞士联邦参考数据的 MCP 服务：瑞士海关关税（TARES）、FINMA 受监管机构登记册和 FINMA 警告名单，以及 NOGA / NACE / ISIC 活动代码对应关系。三种工具无需密钥或注册即可使用。

此软件包是连接到远程 OpenSwissData MCP 端点的小型 STDIO 桥接程序，适用于只能启动本地进程的客户端。支持通过 HTTP 使用 MCP 的客户端可以直接连接到 https://mcp.openswissdata.com/jsonrpc，无需使用此程序。

免费工具（无需密钥）

限制：每个 IP 地址每小时 100 次调用。

工具	功能
tariff_lookup	输入 8 位瑞士关税编号（可带点，例如 8471.3000），返回完整的 TARES 条目：FR/DE/IT/EN 语种的描述、最惠国税率、优惠制度、限制和海关减免代码。输入 2 至 7 位 HS 前缀（例如国际 HS6 代码 847130），可列出其下的瑞士 8 位条目。
kyc_check	按机构名称搜索 FINMA 登记册和 FINMA 警告名单。
cross_walk	在 NOGA 2008、NOGA 2025、NACE 2.0、NACE 2.1 和 ISIC 4 之间转换活动代码，并提供关系类型及其来源。

其他工具（tariff_semantic_search、classify_text、finma_search、tariff_changelog、entity_history）需要现有访问权限；目前不开放新的付费订阅。购买数据集文件不会创建 API 密钥。statent_lookup 已撤下。

设置

Claude Code，远程端点（无需桥接程序）：

claude mcp add --transport http openswissdata https://mcp.openswissdata.com/jsonrpc

使用 mcpServers 配置并运行本地进程的客户端（Claude Desktop、Cline 等）：

{
  "mcpServers": {
    "openswissdata": {
      "command": "npx",
      "args": ["-y", "@openswissdata/mcp"]
    }
  }
}

每次列出工具时，工具及其架构都会从服务端获取。

变量	默认值	用途
OPENSWISSDATA_API_KEY	无	现有 OAuth 令牌，按其所包含的权限使用
OPENSWISSDATA_BASE_URL	https://mcp.openswissdata.com	替代服务端
OPENSWISSDATA_TIMEOUT_MS	30000	超时时间，包括读取完整响应的时间

请将密钥保存在客户端的私有配置中。诊断信息输出到 stderr；stdout 专用于协议。openswissdata-mcp --version 和 --help 会显示版本和帮助信息。

开发

检查使用 Node 22 运行。运行时仍声明支持 Node 18 及以上版本；请使用仍受维护的版本。

npm ci
npm run typecheck
npm test
npm run build
npm pack --dry-run

测试会使用官方 SDK 执行完整的 MCP 交互，并中断响应正文卡住的情况。仓库中的更改不会发布新的 npm 版本：分发前请单独检查软件包注册表。

Dockerfile 提供本地替代方案：docker build -t openswissdata-mcp .，然后运行 docker run --rm -i openswissdata-mcp。

限制

OpenSwissData 是非官方副本。请保留向用户显示的声明。近似对应关系需要专家验证；缺少关税数值并不表示免税；未找到 FINMA 结果并非合规证明。作出任何决定前，请核对原始来源（xtares.admin.ch、finma.ch、瑞士联邦统计局）。

完整数据集以签名文件形式出售，详见 openswissdata.com。面向 AI Agent 的摘要见 openswissdata.com/llms.txt。

Apache-2.0 许可证。所用 MCP SDK 的文档。