Openswissdata

@openswissdata/mcp

スイス連邦の参照データを扱う MCP サーバーです。スイス関税率表（TARES）、FINMA の監督対象機関登録簿と FINMA 警告リスト、NOGA／NACE／ISIC の産業コード対応を提供します。3 つのツールは、キーや登録なしで利用できます。

このパッケージは、ローカルプロセスのみを起動するクライアント向けの、リモート OpenSwissData MCP エンドポイントへの小規模な STDIO ブリッジです。HTTP 経由の MCP に対応するクライアントは、ブリッジを介さずに https://mcp.openswissdata.com/jsonrpc に直接接続できます。

無料ツール（キー不要）

制限：IP アドレスごとに 1 時間あたり 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 エージェント向けの概要は openswissdata.com/llms.txt にあります。

Apache-2.0 ライセンス。使用している MCP SDK のドキュメント。