importproof

importproof

商品が動き出す前に、輸入者が確認したいのは簡潔な証跡です。このEORI番号は形式上正しく、実在が確認できるか、どのTARICコードが商品を表す候補になり得るか、特定の原産地に対して候補コードにどのEU措置が適用されるか、そして関税軽減措置と仕向地のVATを考慮した場合、小口貨物の費用はいくらになりそうか。importproofは、これら5つの事前確認を1つのMCPインターフェースにまとめます。

確認処理はホスト型サービス上で実行されます。このパッケージはローカル側の部分です。サービスから取得した定義に基づいてツール一覧に応答し、すべての呼び出しをサービスに中継して、受け取ったとおりに応答を返します。回答は申告者が確認するための根拠であり、確定判断ではありません。候補分類は候補のままであり、日付付きスナップショットに基づく措置は結論の代わりに要確認のシグナルを返すことがあり、費用の数値は提示された情報に基づく見積もりです。不足している入力は推測で補わず、不足として報告します。

ここで税関申告を行ったり、関税を徴収または納付したり、輸送を予約したり、領収書をどこかに提出したりすることはありません。領収書ツールは、呼び出し元が以前に行った確認をまとめ、何をいつ確認したかを記録した署名付き記録を作成するだけです。

ツール

• validate_eori — EORI番号を確認します。eori（最大20文字）を受け取ります。応答では形式上の有効性と、権威ある情報源による実在確認の結果を分けて示します。プロバイダーを利用できない場合は、確認失敗としてではなく、その旨を報告します。
• search_taric_codes — 商品の候補となるTARIC/CNコードを提示します。productDescription（最大500文字）と、任意でknownProperties（素材や用途など、短い属性文字列のリスト）を受け取ります。候補は日付付きスナップショットから取得され、根拠とともに順位付けされます。
• check_eu_import_measures — 候補コードに適用されるEUレベルの措置を一覧表示します。code、originCountry、destinationCountry（ISO alpha-2）を受け取り、任意でdate、goodsValueEur、itemCountを指定できます。日付付きスナップショットに基づき、第三国関税、特恵措置、禁止・制限措置、監視措置を対象とします。
• estimate_low_value_import_cost — 本質的価値がEUR 150以下の貨物について、着地コストを見積もります。destinationCountry、currency、items（各項目にはintrinsicValueが必要で、任意でtaricCandidateを指定できます）を受け取り、任意でoriginCountry、関税制度を選択するasOfDate、iossUsed、destinationVatRatePercentを指定できます。
• prepare_import_preflight_receipt — 以前の確認をまとめて、1つの署名付き領収書を作成します。bundle（証明対象となる事前確認の結果）とcreatedAt（バンドルを作成したISOタイムスタンプ）が必要です。領収書が証明するのは確認を行ったことです。コンプライアンスや通関の結果を証明するものではありません。

最初の4つのツールについては、取得したスキーマに必須フィールドの一覧はありません。必須のbundleとcreatedAt引数があるのは領収書ツールだけです。

設定

• EU_IMPORT_MCP_URL（任意） — 上流エンドポイントを変更します。指定しない場合はhttps://import.mcp.jithox.com/mcpがデフォルトです。この上書き用フックは、この再構築版であることを明示した再現機能です。
• EU_IMPORT_API_KEY（任意） — 設定すると、すべての上流リクエストに呼び出し元のキーを含むAuthorization: Bearer <value>ヘッダーを追加します。未設定の場合、キーのヘッダーは送信されません。ヘッダー名は元サービスのレジストリレコードに従っています。そのレコードではパッケージの環境変数名が指定されていないため、環境変数名、Bearer形式、転送動作は再現したものとして明示しています。元のインターフェースはキーなしで取得されました。

呼び出しの流れ

クライアントからの最初の呼び出しでは、順番に3つのJSON-RPC POSTを送信してセッションを開始します。まず、プロトコルバージョン2025-03-26とクライアント名importproofを指定してinitializeを送信し、次にnotifications/initialized通知を送信し、その後、呼び出し元の引数を変更せずにtools/callを送信します。initializeの応答にMcp-Session-Idヘッダーが設定されている場合、その値は以降のリクエストで送信され、セッションはその後も再利用されます。プレーンなJSON形式と、サーバー送信イベント形式のどちらの応答にも対応しています。

成功した応答は、上流側で設定されたエラーフラグも含め、そのまま返されます。完了できない呼び出し（上流側のJSON-RPCエラー、成功以外のHTTPステータス、JSON-RPCとして読み取れない本文、またはトランスポート障害）は、テキストがimportproof error:で始まるエラー結果になります（この表現は、この再構築版で定義したラベルです）。

CLI

各ツールは、引数としてJSONオブジェクトの文字列を1つ受け取るサブコマンドとしても利用できます。

npx @reneturcios/importproof validate_eori '{"eori":"BE0123456749"}'
npx @reneturcios/importproof search_taric_codes '{"productDescription":"cotton t-shirt"}'
npx @reneturcios/importproof --version

終了コードは、呼び出し成功時が0、エラー結果の場合が1、使用方法のエラーの場合が2です。

MCP サーバー

npx -y @reneturcios/importproof mcp

MCP クライアントの設定：

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

Docker

docker run -i ghcr.io/cloudcorprecords/importproof
docker run --rm ghcr.io/cloudcorprecords/importproof --version

引数を指定しない場合、コンテナはstdio経由でMCP サーバーを起動します。それ以外の引数はCLIで処理されます。

開発

npm install
npm run build
npm test
npm run dev

テストでは上流のJSON-RPCサービスをスタブ化するため、テストスイートは実際のネットワーク呼び出しを行いません。

ライセンス

MIT — LICENSEを参照してください。