ShipStation API MCP 服务器

一个全面的模型上下文协议 (MCP) 服务器，用于与 ShipStation API 交互。此服务器提供用于管理订单、发货、承运商、仓库、产品、客户、商店、Webhook 和履行的工具和资源。

## 功能

- 完整覆盖 ShipStation API 端点
- 适用于所有 API 操作的结构化工具
- API 参考文档资源
- 错误处理和日志记录

## 快速入门

1. 克隆此存储库
2. 安装依赖项：
   ```
   npm install
   ```
3. 创建一个包含您的 ShipStation API 凭据的 `.env` 文件：
   ```
   SHIPSTATION_API_KEY=您的_API_密钥
   SHIPSTATION_API_SECRET=您的_API_密钥
   ```
4. 运行服务器：
   ```
   npm run dev
   ```
5. 使用 MCP Inspector 进行测试：
   ```
   npm run inspect
   ```

## API 文档

通过 `shipstation://docs/{section}` 资源访问 API 文档。可用部分：

- overview (概述)
- orders (订单)
- shipments (发货)
- carriers (承运商)
- warehouses (仓库)
- products (产品)
- customers (客户)
- stores (商店)
- webhooks (Webhook)
- fulfillments (履行)

示例：`shipstation://docs/orders`

## 可用工具

### 订单
- list_orders (列出订单)
- get_order (获取订单)
- create_order (创建订单)
- mark_order_as_shipped (标记订单为已发货)
- delete_order (删除订单)
- add_tag_to_order (向订单添加标签)
- remove_tag_from_order (从订单中删除标签)
- restore_order_from_hold (从保留中恢复订单)
- hold_order_until (将订单保留至)

### 发货
- list_shipments (列出发货)
- get_shipment (获取发货)
- create_label (创建标签)
- void_label (取消标签)

### 承运商
- list_carriers (列出承运商)
- list_carrier_packages (列出承运商包裹)
- list_carrier_services (列出承运商服务)

### 仓库
- list_warehouses (列出仓库)
- get_warehouse (获取仓库)
- create_warehouse (创建仓库)
- update_warehouse (更新仓库)
- delete_warehouse (删除仓库)

### 产品
- list_products (列出产品)
- get_product (获取产品)
- create_product (创建产品)
- update_product (更新产品)
- delete_product (删除产品)

### 客户
- list_customers (列出客户)
- get_customer (获取客户)

### 商店
- list_stores (列出商店)
- get_store (获取商店)
- list_marketplaces (列出市场)
- refresh_store (刷新商店)
- deactivate_store (停用商店)
- reactivate_store (重新激活商店)

### Webhook
- list_webhooks (列出 Webhook)
- subscribe_to_webhook (订阅 Webhook)
- unsubscribe_from_webhook (取消订阅 Webhook)

### 履行
- list_fulfillments (列出履行)
- create_fulfillment_order (创建履行订单)

## 许可证

MIT