proship-mcp

无状态MCP（模型上下文协议）服务器，允许任何AI代理通过ProShip创建泰国邮政货件、打印标签和追踪包裹。

• 端点： POST https://mcp.proship.me/mcp（JSON-RPC 2.0，application/json）

• 文档： 在浏览器中打开 https://mcp.proship.me/mcp —— 文档页面由实时工具注册表生成

• 认证： Authorization: Bearer <ProShip API token>，原样传递给 api.proship.me。服务器端不存储任何内容。新用户可以调用公共 signup 工具获取令牌。

工具

公共：track_parcel、get_order_statuses、signup。 需认证：list_shops、create_order、list_orders、get_order、update_order_status、cancel_order、check_duplicate、print_label。

位于 /mcp 的浏览器文档页面是权威且始终最新的工具参考。

Related MCP server: shipsaving-mcp

运行

npm install
npm start          # listens on PORT (default 3000)
npm test           # node:test suite, upstream fully mocked

环境变量

部署

Fly.io 应用 proship-mcp（区域 sin）：

fly deploy            # add --depot=false if the Depot builder fails

备注

• 订单ID带有管道后缀（order-xxx|123）。GET/PUT/DELETE 内部会去除后缀；print_label 需要完整的ID。在工具之间始终传递完整的ID。

• 重量单位为克。状态码使用泰国管道（get_order_statuses）；尽管上游将其标记为“ERROR”，但代码6表示“正在派送”。

• 唯一的服务器状态是标签PDF的10分钟内存缓存，以便 print_label 可以返回URL。