HimiTrace

HimiTrace MCP Server — AI エージェント向けブロックチェーン製品トレーサビリティ（TypeScript 移植版）

HimiTrace は、AI エージェントを Polygon Mainnet ブロックチェーンに直接接続し、製品の真正性の確認、原産地の検証、サプライチェーンイベントの系譜の調査を可能にする Model Context Protocol（MCP）サーバーです。HimiTek（himitek.com）が開発し、改ざん不可能なオンチェーンの信頼データと、AI エージェント向けの自然言語クエリを橋渡しします。

これにより、Claude Desktop、Cursor、Windsurf、ChatGPT などの MCP 対応 AI エージェントは、平易な言葉でオンチェーンの物品を照会、追跡、監査できます。

---

主な機能

• オンチェーン検証： 製品またはロット ID が Polygon ブロックチェーンに登録されているかを検証します（改ざん防止、不変）。
• サプライチェーンのタイムライン（GS1 EPCIS 互換）： Polygon から製品の全イベントログ（収穫、加工、梱包、出荷）を時系列順に取得します。
• 証明書の検証： IPFS に保存され、ハッシュがオンチェーンに記録された品質証明書（USDA Organic、VietGAP、Fair Trade など）にアクセスします。
• BOM（部品表）の系譜： 原材料ロットの親子関係や、統合・分割の関係を追跡します。
• ガス代不要： スマートコントラクトからのすべての読み取り操作は完全に無料で、AI エージェントが暗号資産トークン（POL）を消費する必要はありません。

---

技術仕様

• コントラクトアドレス： 0xFF7A3429427aFda56b2994B2F3eeF4464b851EE0
• ネットワーク： Polygon Mainnet（Chain ID：137）
• フレームワーク： TypeScript と ethers.js（v6）を使用し、Anthropic の Model Context Protocol（MCP）SDK を基盤に構築されています。

---

インストールとセットアップ

1. 前提条件

• Node.js v20 以上
• npm

2. 依存関係のインストール

リポジトリをクローンし、パッケージをインストールします：

npm install

3. プロジェクトのビルド

TypeScript を Javascript にコンパイルします：

npm run build

4. 接続のテスト

サーバーが Polygon のコントラクトに接続し、ローカルでツールを照会できることを確認します：

npm run test:local

ALL TESTS PASSED と表示されたら、環境は正しく設定されています。

---

AI クライアントへの接続

1. Claude Desktop

Claude Desktop の設定ファイルに HimiTrace MCP を追加します。

• Windows： %APPDATA%\Claude\claude_desktop_config.json
• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

mcpServers オブジェクトに以下を追加します：

{
  "mcpServers": {
    "himitrace-mcp": {
      "command": "node",
      "args": [
        "C:/path/to/your/himitrace-mcp/dist/index.js"
      ]
    }
  }
}

注：C:/path/to/your/himitrace-mcp/dist/index.js を、コンパイルされたエントリーポイントの実際の絶対パスに置き換えてください。

2. Cursor または Windsurf IDE

Cursor の設定で：

1. Settings > Features > MCP に移動します。
2. + Add New MCP Server をクリックします。
3. 各項目に入力します：
   • Name： HimiTrace
   • Type： command
   • Command： node "C:/path/to/your/himitrace-mcp/dist/index.js"

---

利用可能なツール

AI エージェントは以下のツールを実行できます：

1. verify_product

製品がオンチェーンに存在するかを確認し、登録パラメーターを取得します。

• 引数： product_id（文字列。例：LOT-20260315-A1B2C3）
• 戻り値： 検証ステータス、名称、原産地、所有者、登録日、エクスプローラーへのリンクを含む JSON。

2. get_trace_history

製品のサプライチェーン履歴（タイムライン）をすべて取得します。

• 引数： product_id（文字列）
• 戻り値： イベントの種類、タイムスタンプ、カスタムペイロードデータ（GS1 EPCIS 標準）、記録者のブロックチェーンウォレットアドレスを含む、時系列順のイベント配列。

3. get_certificates

製品に紐づく証明書を取得します。

• 引数： product_id（文字列）
• 戻り値： 証明書の種類、発行者、発行日／有効期限、および安全な IPFS ゲートウェイリンクの一覧です。

4. get_batch_lineage

部品表（BOM）の系譜（バッチの分割と統合）を追跡します。

• 引数： batch_id（文字列）
• 戻り値： 原材料入力の親子関係、数量、単位です。

5. check_product_exists

製品が存在するかをすばやく確認します。

• 引数： product_id（文字列）
• 戻り値： True／False の状態です。

6. get_system_stats

システム全体の統計情報を提供します。

• 戻り値： 登録済み製品数、コントラクトの詳細、ウォレット残高です。

---

利用可能なリソース

AI エージェントは、以下の静的リソースを参照できます。

• himitrace://info：システムの一般的なドキュメント、準拠業界、規格。
• himitrace://contract：ブロックチェーンのメタデータ（chain_id、RPC ノード、コントラクトコードのバージョン）。
• himitrace://pricing：API 利用上限の料金プラン（Free、Pro、Enterprise）。

---

ライセンスとサポート

HimiTek Joint Stock Company が開発・保守しています。

• ウェブサイト：himitek.com
• サポートメール：[email protected]
• ポータル：trace.himitek.vn