ShipHero MCP 服务器

一个全面的模型上下文协议（MCP）服务器，用于与ShipHero API交互。

## 功能

- 完全覆盖ShipHero API端点
- 自动刷新令牌的身份验证处理
- 速率限制支持
- 全面的错误处理
- 文档资源

## 安装

bash
npm install shiphero-mcp-server


## 配置

创建一个包含您的ShipHero API凭据的`.env`文件：


SHIPHERO_API_KEY=your_api_key_here
SHIPHERO_API_SECRET=your_api_secret_here


## 使用

### 运行服务器

bash
npx shiphero-mcp


### 使用MCP检查器测试

bash
npx @modelcontextprotocol/inspector npx shiphero-mcp


## 可用工具

### 订单
- `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`: 更新现有供应商

### Webhook
- `list_webhooks`: 列出所有Webhook订阅
- `create_webhook`: 创建新的Webhook订阅
- `delete_webhook`: 删除Webhook订阅

## 文档资源

通过`shiphero://docs/{section}`资源访问文档，其中`{section}`可以是：
- `overview`: 通用API概览
- `orders`: 订单API文档
- `products`: 产品API文档
- `inventory`: 库存API文档
- `shipping`: 发货API文档
- `warehouses`: 仓库API文档
- `vendors`: 供应商API文档
- `webhooks`: Webhook API文档

## 许可证

MIT