ShipStation API MCP Server

ShipStation API MCP サーバー

ShipStation API と連携するための、包括的な Model Context Protocol（MCP）サーバーです。このサーバーは、注文、出荷、配送業者、倉庫、商品、顧客、ストア、ウェブフック、フルフィルメントを管理するためのツールとリソースを提供します。

## 機能

- 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 ドキュメントにアクセスできます。利用可能なセクション：

- overview
- orders
- shipments
- carriers
- warehouses
- products
- customers
- stores
- webhooks
- 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

### ウェブフック
- list_webhooks
- subscribe_to_webhook
- unsubscribe_from_webhook

### フルフィルメント
- list_fulfillments
- create_fulfillment_order

## ライセンス

MIT