Hansatic

Hansatic MCP — AI エージェント向け積載計画

AI エージェントに、トラックや輸送コンテナへ荷物を積み込む機能を追加します。この MCP サーバーは、 Hansatic packing API をラップします。貨物明細を送信すると、 回転、積み重ね、壊れやすさ、重量、車軸の制約を考慮した、物理的に実現可能な配置に加え、 重要な運賃請求指標であるLDM（積載メートル）、フィート（リニアフィート）、EUR パレット 積載位置数が返されます。

「13.6m のカーテンサイダーに機械用木箱 14 個と EUR パレット 8 枚を積載する」 → 1 回のツール呼び出しで、LDM 5.25 の検証済み 3D 積載計画が得られます。

セットアップ

1. API キーを取得します（無料）：hansatic.com → サインイン → 名前をクリック → API → キーを生成。各アカウントには毎月 25 回分の無料 サンドボックスパックが含まれており、試すのにサブスクリプションは必要ありません。

2. サーバーを MCP クライアントに追加します：

Claude Code

claude mcp add hansatic -e HANSATIC_API_KEY=hk_live_... -- npx -y hansatic-mcp

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "hansatic": {
      "command": "npx",
      "args": ["-y", "hansatic-mcp"],
      "env": { "HANSATIC_API_KEY": "hk_live_..." }
    }
  }
}

Cursor（.cursor/mcp.json）— Claude Desktop と同じ形式です。

ツール

ツール	機能
pack_cargo	貨物明細を車両に最適に積載します。内部では非同期で処理され、完了した配置と指標を 1 回の呼び出しで返します（通常 5～30 秒）。本番アカウントでは plan_url が取得でき、Hansatic の 3D エディターで配置を開けます。
list_vehicles	内寸と積載量を含む、組み込みのすべてのトラック、トレーラー、コンテナを返します。有効な vehicle コードを確認できます。
check_job	ジョブ ID を指定してジョブをポーリングします（非常に大きな貨物明細がツールのタイムアウトを超える場合にのみ使用します）。

注意事項

• 単位：デフォルトはメートル法（mm/kg）です。インチ／ポンドを使用するには units: "imperial" を 渡します。結果は指定した単位で返されます。
• サンドボックスと本番環境：エンタープライズ以外のキーでは自動的にサンドボックスが使用されます（結果はすべて返され、永続化されません）。エンタープライズキーではワークスペースに実際の計画が作成され、返された plan_url で編集できます。
• エンジンは、実際のディスパッチャーによる積載配置を基準に継続的に検証されています — アルゴリズムの評価方法をご覧ください。
• REST API、OpenAPI 仕様、全ドキュメント：hansatic.com/en/docs

MIT ライセンスです。最適化エンジンは hansatic.com でサーバーサイド実行されます。