mcpField
H
Hansatic

Hansatic

本地服务
github.com/1aleksa地图与出行016 周前更新
代码仓库

关于 Hansatic

Hansatic 是面向 AI Agent 的 MCP 服务，可将货物清单提交给 Hansatic 配载 API，并返回经过验证的卡车或集装箱装载布局。它会考虑实际装载约束，并提供 LDM、线性英尺和 EUR 托盘位等货运指标。

主要功能

  1. 01按车辆优化货物清单
  2. 02遵循旋转、堆叠、易碎、重量和车轴约束
  3. 03返回 LDM、线性英尺和 EUR 托盘位
  4. 04列出内置卡车、拖车和集装箱
  5. 05轮询长时间运行的配载任务

适用场景

  1. 01根据货物清单规划卡车装载
  2. 02查询车辆尺寸和载荷信息
  3. 03获取大型配载任务的结果

MCP 相关

该 MCP 服务向 MCP 客户端提供 `pack_cargo`、`list_vehicles` 和 `check_job` 工具，并使用 API 密钥连接 Hansatic 配载 API。

#freight#logistics#supply-chain#bin-packing

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "hansatic": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote"
      ],
      "env": {
        "HANSATIC_API_KEY": "<HANSATIC_API_KEY>"
      }
    }
  }
}
启动命令npx -y mcp-remote
需要配置的环境变量
HANSATIC_API_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmmcp-remote

工具

3

收录的工具列表 · 更新于 3 周前

参数类型必填说明
vehiclestring是车辆代码，例如 CURTAINSIDER_136（13.6m 篷布侧帘车）或 40HC（40ft 高箱集装箱）。使用 list_vehicles 获取有效代码。
itemsarray是货物清单
objectiveenum否最小化装载米数（默认）或计费托盘位ldm | pallets
unitsenum否项目编号的读取和返回单位：mm/kg（默认）或 in/lbmetric | imperial
sandboxboolean否强制使用沙盒模式（不保存任何内容）。省略此项则由账户等级决定：企业账户会创建带可分享链接的实际方案，其他账户则自动使用沙盒模式。
namestring否方案名称（生产模式）
ldm_limit_mnumber否将装载限制在前 N 装载米（卡车）

详细介绍

Hansatic MCP — 为 AI Agent 规划装载

让你的 AI Agent 能够将货物装入卡车和集装箱。这个 MCP 服务封装了 Hansatic 装载 API：提交货物清单， 即可获得符合物理条件的布局——摆放方案会遵守旋转、堆叠、 易碎性、重量和车轴限制——以及重要的货运计费指标：LDM（装载米数）、线性英尺和 EUR 托盘位。

“将 14 个机器箱和 8 个 EUR 托盘装入一辆 13.6 m 篷布侧帘车” → 一次工具调用，即可获得经验证的 3D 装载方案，装载米数为 5.25 LDM。

设置

  1. 获取 API 密钥（免费）：访问 hansatic.com → 登录 → 点击你的姓名 → API → Generate key。每个账户每月可免费进行 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将货物清单优化装入车辆。底层采用异步处理；一次调用即可返回完成后的布局和指标（通常需要 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 服务器端运行。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。