Commerce Evidence Toolkit

Commerce Evidence Toolkit

製品データを扱うエージェント向けの、ローカルで実行する読み取り専用チェックが3つ用意されています。このパッケージは、Agentic Commerce Field Guideで公開されている、バージョン管理された同じ比較ルールをラップしています。

バージョン 0.1.0 · MIT ライセンス。 バージョン付きリリースをダウンロードするか、以下の手順でソースを実行してください。レジストリでの公開状況はGitHubリリースとは別です。現在の状況はレジストリで確認してください。

概要

ツール	入力	結果
review_product_record	1つの製品オブジェクト、任意の提供証拠、copyまたはmappedメソッド	選択したフィールドのレビュー：clearまたはhold
compare_feed_snapshots	明示的に指定されたソースとフィードのスナップショット、アイテム ID、証拠の参照、タイムスタンプ、経過時間ポリシー	match、update_neededまたはhold
compare_dimensions	同一アイテムと測定基準、名前付きの長さ・幅・高さ、単位、許容差	match、mismatchまたはhold

このチェックは、参照先の取得、証拠の認証、販売業者への連絡、フィードの変更、注文の実行、テレメトリーの送信を行いません。一致しても、プロバイダーによる受け入れ、現在の製品情報、物理的な適合、互換性を意味するものではありません。これは選択した項目をローカルでレビューする契約であり、プロバイダーのスキーマ全体を検証するものではありません。保留の結果は証拠に基づく判断であり、プロトコルの失敗ではありません。

バージョン付きバンドルのインストール

v0.1.0リリースからcommerce-evidence-toolkit-0.1.0.mcpbとSHA256SUMSをダウンロードしてください。公開されているSHA-256チェックサムと照合して、アーカイブを確認してください。バンドルにはサーバーと本番用の依存関係が含まれています。Node.js 22以降が必要です。

互換性のあるクライアントのMCPBインポート手順を使うか、アーカイブをディレクトリに展開し、以下のJSON例を使ってserver/index.mjsの絶対パスを設定してください。MCPBへの対応状況はクライアントによって異なります。プロトコルテストは、いずれかのデスクトップアプリによる認定を示すものではありません。

Nodeパッケージのアーカイブもリリースに含まれています。このアーカイブのインストールには、依存関係をインストールするためのnpmが必要です。npmには公開されていません。

ソースから実行

Node.js 22以降とnpmが必要です。依存関係のインストールにはネットワークを使用します。インストール後、3つの比較操作はローカルで実行されます。

npm ci --ignore-scripts
npm test
node server/index.mjs

最後のコマンドは、標準入力／出力を介してMCP サーバーを起動します。互換性のあるクライアントからの接続を待ち受けます。ブラウザー用のURLではありません。プロトコルが使用するstdoutにデバッグメッセージを出力しないでください。

MCP JSON設定を受け付ける互換性のあるクライアントを使う場合は、以下のパスをチェックアウト先の絶対パスに置き換えてください。

{
  "mcpServers": {
    "commerce-evidence": {
      "command": "node",
      "args": ["/absolute/path/agentic-commerce-field-guide/server/index.mjs"]
    }
  }
}

クライアントによって設定場所は異なります。この例ではトランスポートと実行可能ファイルを指定していますが、すべてのアシスタントが自動的にサーバーをインストールまたは呼び出すことを示すものではありません。

入力全体を試す

examples/ にあるファイルは、内部レコードそのものではなく、完全なツール引数です。以下の3つのスターター例は架空のもので、該当する箇所では固定時刻を使用しています。

ツール	引数ファイル	期待される結果の例
compare_dimensions	examples/dimensions.json	match
compare_feed_snapshots	examples/feed-snapshots.json	update_needed
review_product_record	examples/product-record.json	明示的なマッピング後に clear

クライアントに、指定したファイルの JSON オブジェクトを使って、名前付きのツールを呼び出すよう依頼してください。成功したレスポンスにはすべて、toolVersion、正規の documentation URL、および完全な result を含む構造化コンテンツが含まれます。各コア結果には、それぞれのルールセットのバージョンと証拠に関する制限が保持されます。受け付けられた入力が不完全な場合は保留となり、不正なエンベロープや過剰なリクエストはプロトコルのツールエラーになります。ラッパーは、シリアル化されたリクエストを UTF-8 で 200,000 バイト、ネストを 25 レベルまでに制限します。個々のチェックには、さらに厳しい制限が設けられています。

寸法の値には、正の10進数文字列と明示的な単位（in、cm、mm、m）を使用します。許容差は、ミリメートル単位の0以上の10進数文字列です。奥行きを長さに黙って置き換えたり、直径を2つの軸として扱ったり、パッケージの寸法で代用したりしないでください。製品レコードのレビューでは、選択された正の USD フィールドを対象とします。フィードの鮮度は、選択された現在の USD スナップショット契約を対象とします。参照情報は呼び出し元の申告であり、取得されることはありません。

実測された比較例

examples/observed-dimensions.json には、9月24日の調査で米国と英国の公開製品ページから確認された HOLMERUD 40541421 の寸法が含まれています。宣言された表示しきい値が2 mmの場合は match、0の場合は mismatch を返します。インチの小数表示は、正確な10進数として表されています。このツールは、リンク先の情報源を取得したり、認証したりしません。このしきい値は、製造または設置の許容差ではありません。この調査では8件の完全な比較と、未解決の掲載情報22件を記録しています。業界のエラー率を推定するものではありません。

検証とパッケージ化

npm run verify:artifacts
npm test
node scripts/test-clean-install.mjs
npm run bundle

npm run bundle は、本番用の依存関係と SHA-256 ファイルを含むローカルの .mcpb アーカイブを dist/ に作成します。Node パッケージは npm pack でビルドできます。ローカルでのパッケージビルドは、npm または MCP Registry への公開ではありません。

テストスイートは、すべての40件のフィクスチャ／メソッドの組み合わせをソースルール（寸法10件、鮮度6件、2つのメソッドによる製品レコード12件）と照合し、エラー境界と入力の不変性を確認したうえで、TypeScript SDK クライアントを使って stdio 経由ですべての40件を実行します。クリーンインストールテストでは、アーカイブを一時ディレクトリにインストールし、3つすべてのツールを呼び出します。別途実施する Python SDK client test では、3つすべての例と、不完全な入力による保留を呼び出します。これらは合成入力を使ったプロトコルテストであり、独立したユーザーによるテストでも、デスクトップアプリの認定でもありません。

根拠と対象範囲

provenance.json には、ソースサイトのコミット、実際の本番ダウンロードを検証した時刻、artifacts/ 内の各ファイルの SHA-256 が記録されています。9 月 24 日のスナップショットでは、既存の商品フィードおよび測定アーティファクトに寸法が追加されています。検証では、ハッシュと、以前のポータビリティ／鮮度に関するケースを再計算します。合成ケースが示すのはルールの動作であり、販売者のエラー率やモデルの精度ではありません。

主なツールのドキュメント：

• 商品レコードのレビュー
• フィードの鮮度
• 寸法の比較
• エージェントのアクセスと編集方針

関連するガイドと、このバージョンまたはコミットを引用してください。著者情報は CITATION.cff に記載されています。修正を報告する場合は、ツールのバージョン、機密情報を含まない最小限の入力、期待される結果、実際の結果、裏付けとなる参照情報を添えて、issue を作成してください。顧客データや認証情報は決して投稿しないでください。

ライセンス

オリジナルのソフトウェア、ドキュメント、テスト、架空のフィクスチャは MIT License の下で利用できます。詳しくは ライセンスの適用範囲 をご覧ください。サードパーティの依存関係には、パッケージ化された依存関係ディレクトリ内に各自のライセンス表示が引き続き適用されます。リンク先の仕様、ソースページ、画像、商標は、このリポジトリによって再ライセンスされるものではありません。