详细介绍
概览
ShipStation API MCP Server 发布在 ShipStation GitHub 组织下（shipstation/mcp-shipstation-api）。它是面向 ShipStation API v2 的 MCP 服务器，让 Claude Desktop 等助手能通过自然语言工具调用创建并管理货件、面单、运费、承运商、库存、仓库、批次与舱单。
可用 Node 直接运行，也可用 Docker 或 Docker Compose。鉴权通过 SHIPSTATION_API_KEY（可选 SHIPSTATION_API_URL 覆盖）。
主要功能
- 货件： 创建、列出、获取、取消货件并检索运费。
- 面单： 创建、列出、获取、作废面单并追踪包裹。
- 运费与承运商： 估算运费；列出承运商、服务与包装类型。
- 库存与仓库： 读取库存水平、更新库存、列出仓库。
- 批次与舱单： 批量面单与日终舱单工作流。
- 部署灵活： README 记录本地 Node、Docker
run或 Compose 形式的 MCP 配置。
如何使用
- 安装兼容 MCP 的客户端（Claude Desktop、Cursor、Claude Code 等）。
- 从 https://github.com/shipstation/mcp-shipstation-api 克隆或安装服务器，按 README 完成构建 /
npx/ Docker。 - 在对应平台申请 API 凭证，写入 MCP 的
env，切勿把密钥提交到 Git。 - 在客户端 MCP 配置（如 Claude Desktop 的
claude_desktop_config.json或 Cursor 的mcp.json）中注册该服务器，然后重启客户端。 - 先用只读问题验证；确认权限与确认开关后再启用写入类工具。
定价
该 MCP 仓库属于 ShipStation 组织下的开源风格工具；运行本身免费。底层账户仍适用 ShipStation 产品定价（面单、套餐档位）。
| 方案 | 计费 | 价格 | 说明 |
|---|---|---|---|
| mcp-shipstation-api | — | 免费自托管 | 需要 API Key |
| ShipStation 账户 | ShipStation 套餐 / 面单 | 按 ShipStation | 承运商面单费用另计 |
适用人群
已在用 ShipStation 发货、希望 Claude/Cursor 询价、作废面单或查看仓库库存、而不必每次打开 ShipStation UI 的多渠道卖家与运营团队。
常见问题
这是非官方项目吗？
仓库位于 shipstation GitHub 组织下，并自述为 ShipStation API v2 的 MCP 服务器——除非 ShipStation 在产品中另有说明，可将其视为一方工具。
如何鉴权？
在 MCP 环境中设置 SHIPSTATION_API_KEY。切勿把含有真实密钥的 .env 提交到版本库。
支持 Docker 吗？
支持——README 在构建文档期望的镜像标签后，提供了 Docker 与 Docker Compose 的 MCP 客户端示例。
对应哪个 API 版本？
文档针对 ShipStation API v2。