(freight Marketplace) Api Cargoffer

欧洲货运市场运营 MCP 层

一个货运市场 MCP 服务，可将 AI Agent（Claude Desktop、Cursor、Cline、Continue 等）连接到 Cargoffer Bolsa de Carga 货运市场 API，让大模型通过自然语言搜索货物、管理拍卖、竞投货运订单、追踪配送，并生成 CMR 运单。

它解决什么问题？ 货运经纪人和承运商要花数小时刷新货运信息平台网站、在不同标签页之间复制数据，并手动发布拍卖更新。这个 MCP 服务将整个 Cargoffer 货运市场转化为可调用的 AI 工具——Agent 可以在一个对话流程中搜索可用货物、创建拍卖、接受竞价、登记卡车并生成法律文件。

它有何不同？ 与屏幕抓取式货运信息平台或单一用途 API 不同，它将完整的市场生命周期作为结构化 MCP 工具开放：拍卖（11 个工具）、地址（4 个）、拖车/卡车司机（4 个）、车辆（4 个）、配送（6 个）和身份验证（2 个）。AI Agent 不只是读取数据，还能进行交易：发布拍卖、接受竞价、生成 CMR PDF。这是一个可读写的运营层，而非只读仪表板。

它支持哪些集成？ 任何兼容 MCP 的客户端都可以调用 35 多个货运市场工具，以自然语言与大模型对话的方式搜索货运订单、管理公司资源、参与拍卖并生成运输文件。

“轻松集成”具体意味着什么？ 克隆仓库，设置 API_KEY=your-key，运行 node src/server.js，然后用一个 JSON 代码块配置 MCP 客户端。无需安装 SDK，无需设置数据库，也无需进行 OAuth 流程。你的 AI Agent 可以立即发布欧洲货运信息平台上的货运订单并参与竞价。

---

为什么要构建这个 MCP

欧洲零担货运市场依托数十个彼此不兼容的货运信息平台运作，每个平台都有自己的登录方式、界面和数据格式。调度员需要手动查看多个平台，将货物详情复制粘贴到电子表格中，并通过 WhatsApp 和电子邮件协调谈判。这个过程缓慢、容易出错，也无法自动化。

这个 MCP 服务将 Cargoffer Bolsa de Carga API——一个统一的欧洲公路运输货运市场——作为一流的大模型工具开放。它让 AI Agent 能够搜索可用货物、创建并发布拍卖、管理竞价、登记公司车辆和司机、追踪配送状态并生成 CMR 运单。它将 AI 助手从聊天界面转变为运营型货运工作台，能够实现物流文件自动化并处理市场交易。

AI Agent 能力

能力	AI 可以做什么
货运监控	实时查找并筛选正在进行的货运拍卖
竞价管理	自动对可用货运订单提交竞价
地址运营	管理运输地址和地点
车队匹配	为货运订单匹配可用车辆和卡车司机
配送追踪	追踪所有货运的配送状态

---

MCP 功能

• 35+ 个 MCP 工具，涵盖 6 个功能领域——拍卖、地址、拖车、车辆、交付、身份验证
• 完整的拍卖生命周期——创建、发布、列出、更新、删除拍卖，接受出价，管理收藏
• 地址簿管理——可重复使用的公司地点（取货、交付、仓库）
• 拖车/卡车司机登记管理——管理车队运力和司机分配
• 车辆管理——登记卡车及其尺寸、载货能力和认证信息
• 交付追踪——列出交付记录、获取详情、下载 CMR PDF、发送交付消息
• CMR 运单生成——直接从交付记录签署并锁定货运合同
• 基于 JWT 的身份验证——服务器透明地处理登录令牌
• 基于 HTTP 的 JSON-RPC 2.0——标准 MCP 传输方式
• 零运行时依赖（Node.js 18+ 除外）——无需 Docker、数据库或构建步骤

---

工具

拍卖（11 个工具）

列出有效拍卖，获取/创建/更新/删除拍卖，发布拍卖，接受出价，签署 CMR，管理收藏。

|| 工具 | 描述 | |------|-------------| | bolsa_auctions_active | 列出有效货运拍卖 | | bolsa_auctions_get | 根据 ID 获取拍卖详情 | | bolsa_auctions_create | 创建新拍卖 | | bolsa_auctions_update | 更新现有拍卖 | | bolsa_auctions_delete | 删除拍卖 | | bolsa_auctions_publish | 将拍卖发布到交易市场 | | bolsa_auctions_accept_bid | 接受拍卖出价 | | bolsa_auctions_sign_cmr | 为拍卖签署 CMR 运单 | | bolsa_auctions_favorites | 管理收藏的拍卖 |

国家/地区（1 个工具）

搜索前验证哪些国家/地区已启用交易市场操作。

|| 工具 | 描述 | |------|-------------| | bolsa_countries_enabled | 列出已启用搜索的国家/地区 |

地址（4 个工具）

工具	描述
bolsa_addresses_list	列出所有地址
bolsa_addresses_create	创建新地址
bolsa_addresses_update	更新地址
bolsa_addresses_delete	删除地址

拖车/卡车司机（4 个工具）

工具	描述
bolsa_trailers_list	列出所有拖车
bolsa_trailers_create	登记新拖车
bolsa_trailers_update	更新拖车信息
bolsa_trailers_delete	移除拖车

车辆（4 个工具）

工具	描述
bolsa_vehicles_list	列出所有车辆
bolsa_vehicles_create	添加新车辆
bolsa_vehicles_update	更新车辆详情
bolsa_vehicles_delete	移除车辆

交付（6 个工具）

工具	描述
bolsa_deliveries_list	列出所有交付记录
bolsa_deliveries_get	获取交付详情
bolsa_deliveries_download_cmr	下载 CMR PDF
bolsa_deliveries_send_message	发送交付消息

身份验证（2 个工具）

工具	描述
bolsa_auth_login	进行身份验证并获取 JWT 令牌
bolsa_auth_register	注册新账户

---

目录结构

bolsa_de_carga-mcp/
├── package.json            # Node.js 18+, ES module, bolsa-de-carga-mcp
├── .env.example            # Environment variable template
├── src/
│   └── server.js           # MCP server entry point (35+ tools, JSON-RPC 2.0)
└── README.md

---

---

身份验证

使用此 MCP 服务需要 Bolsa de Carga 平台的 API 密钥。

注册： https://cia.cargoffer.com

创建账户，然后在个人资料设置中获取 API 密钥。接着进行配置：

export API_KEY="your-api-key"

或者在 MCP 客户端配置中：

{
  "mcpServers": {
    "bolsa-de-carga": {
      "command": "...",
      "env": {
        "API_KEY": "your-api-key-from-cia"
      }
    }
  }
}

快速开始

# Clone
git clone https://github.com/cargoffer/bolsa_de_carga-mcp.git
cd bolsa_de_carga-mcp

# Configure with your API key
export API_KEY="your-api-key"

# Run
node src/server.js

服务器将在 http://localhost:3000 启动，并提供 JSON-RPC 2.0 端点。

---

安装

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "bolsa-de-carga": {
      "command": "node",
      "args": ["/path/to/bolsa_de_carga-mcp/src/server.js"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

在 Cursor 设置 → 功能 → MCP 服务 → 添加新服务 中：

Name:   bolsa-de-carga
Type:   command
Command: node /path/to/bolsa_de_carga-mcp/src/server.js
Env:    API_KEY=your-api-key

直接使用 HTTP（用于自定义集成）

curl -X POST http://localhost:3000 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "bolsa_auctions_active",
    "params": {"limit": 10}
  }'

---

MCP 协议实战

搜索有效货运拍卖：

curl -X POST http://localhost:3000 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "bolsa_auctions_active",
    "params": {
      "limit": 10,
      "from": "Madrid",
      "to": "Barcelona"
    }
  }'

响应：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "status": 200,
    "data": {
      "docs": [
        {
          "serviceCode": "MADBCNnT4FN",
          "from": { "city": "Madrid", "country": "ES" },
          "to": { "city": "Barcelona", "country": "ES" },
          "goods": { "description": "General cargo", "weight": 1000 },
          "status": "active"
        }
      ]
    }
  }
}

创建并发布新的货运拍卖：

curl -X POST http://localhost:3000 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "bolsa_auctions_create",
    "params": {
      "fromAddressId": "addr_123",
      "toAddressId": "addr_456",
      "goods": {
        "description": "Industrial machinery",
        "weight": 5000,
        "palletCount": 4
      },
      "pickupDate": "2026-06-01",
      "deliveryDate": "2026-06-03"
    }
  }'

---

AI Agent 示例提示词

“显示从 Madrid 到 Barcelona、重量低于 10 吨的所有在运货物。”

“创建一笔从 Valencia 运往 Seville 的 5 吨机械设备货运拍卖，提货时间为下周一。”

“接受拍卖 MADBCNnT4FN 中的最高报价，并生成 CMR 运单。”

“为我们的车队登记一辆载重能力为 24 吨、配有冷藏挂车的新卡车。”

“列出所有待签署 CMR 的交付任务，并下载其运单 PDF。”

“我们本月的拍卖中标率是多少？显示已结束和进行中的拍卖。”

---

环境变量

变量	描述	默认值
API_KEY	Cargoffer API 密钥（生产环境必需）	-
API_URL	API 基础 URL	https://api.pro.cargoffer.com
PORT	服务端口	3000

本地开发

# Use local backend
API_URL=http://localhost:8090 API_KEY=your-key node src/server.js

# Or copy .env.example
cp .env.example .env
# Edit .env with your values
node src/server.js

.env.example 文件包含模板：

API_KEY=your-key
API_URL=https://api.pro.cargoffer.com
PORT=3000

---

API 端点

端点	方法	描述
/health	GET	健康检查
/tools	GET	列出可用工具
/	POST	JSON-RPC 2.0 端点

---

语义标签

freight marketplace MCP load board API MCP server Model Context Protocol European road transport logistics document automation Bolsa de Carga freight auction load board truck brokerage CMR waybill freight matching AI agents LLM tools supply chain spot market Cargoffer trucking freight logistics Spain cargo easy MCP integration

---

获取 API 密钥

请联系 Cargoffer，获取用于生产环境的 API 密钥：

• 电子邮件： [email protected]
• 或通过 Cargoffer 控制面板申请

---

许可证

MIT — 详情请参阅 LICENSE 文件。

---

链接

• 代码仓库： github.com/cargoffer/bolsa_de_carga-mcp
• 问题反馈： github.com/cargoffer/bolsa_de_carga-mcp/issues
• MCP 协议： modelcontextprotocol.io