ShipStation API MCP Server

一个全面的模型上下文协议（MCP）服务器，用于与ShipStation API交互。该服务器提供了管理订单、发货、承运人、仓库、产品、客户、商店、网络钩子和履行的工具和资源。

## 功能

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

## 快速开始

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

## API 文档

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

- 概览
- 订单
- 发货
- 承运人
- 仓库
- 产品
- 客户
- 商店
- 网络钩子
- 履行

示例：`shipstation://docs/订单`

## 可用工具

### 订单
- 列出订单
- 获取订单
- 创建订单
- 标记订单为已发货
- 删除订单
- 向订单添加标签
- 从订单移除标签
- 从保留中恢复订单
- 将订单保留至

### 发货
- 列出发货
- 获取发货
- 创建标签
- 注销标签

### 承运人
- 列出承运人
- 列出承运人包装
- 列出承运人服务

### 仓库
- 列出仓库
- 获取仓库
- 创建仓库
- 更新仓库
- 删除仓库

### 产品
- 列出产品
- 获取产品
- 创建产品
- 更新产品
- 删除产品

### 客户
- 列出客户
- 获取客户

### 商店
- 列出商店
- 获取商店
- 列出市场
- 刷新商店
- 停用商店
- 激活商店

### 网络钩子
- 列出网络钩子
- 订阅网络钩子
- 取消订阅网络钩子

### 履行
- 列出履行
- 创建履行订单

## 许可证

MIT