使用说明
基本能力
产品定位
ShipHero MCP Server是一个全面的模型上下文协议（MCP）服务器，用于与ShipHero API进行交互。
核心功能
- 完整的ShipHero API端点覆盖
- 自动令牌刷新的认证处理
- 速率限制支持
- 全面的错误处理
- 文档资源
适用场景
- 电商订单管理
- 产品管理
- 库存管理
- 物流管理
- 仓库管理
- 供应商管理
- Webhook订阅
工具列表
订单
get_order: 通过ID检索特定订单list_orders: 列出订单，可选过滤create_order: 创建新订单update_order: 更新现有订单cancel_order: 取消订单
产品
get_product: 通过ID检索特定产品list_products: 列出产品，可选过滤create_product: 创建新产品update_product: 更新现有产品delete_product: 删除产品
库存
get_inventory: 获取产品的库存水平adjust_inventory: 调整库存水平list_inventory_movements: 列出库存变动get_inventory_by_location: 按仓库位置获取库存
物流
get_shipment: 通过ID检索特定发货list_shipments: 列出发货，可选过滤create_shipment: 创建新发货get_shipping_rates: 获取包裹的运费create_return: 创建退货发货
仓库
list_warehouses: 列出所有仓库get_warehouse: 获取特定仓库的详细信息list_locations: 列出仓库内的位置
供应商
list_vendors: 列出所有供应商get_vendor: 获取特定供应商的详细信息create_vendor: 创建新供应商update_vendor: 更新现有供应商
Webhooks
list_webhooks: 列出所有Webhook订阅create_webhook: 创建新Webhook订阅delete_webhook: 删除Webhook订阅
使用教程
使用依赖
确保已安装Node.js和npm。
安装教程
npm install shiphero-mcp-server
配置
创建一个.env文件，包含您的ShipHero API凭证：
SHIPHERO_API_KEY=your_api_key_here
SHIPHERO_API_SECRET=your_api_secret_here
运行服务器
npx shiphero-mcp
调试方式
使用MCP Inspector进行测试：
npx @modelcontextprotocol/inspector npx shiphero-mcp
