Shipbob MCP Server

🚀 ShipBob API MCP サーバー

この MCP サーバーは、ShipBob の電子商取引履行 API とやり取りするための主要な機能ツールを提供します。これにより、商品管理や注文処理、在庫管理など、様々な業務を効率的に行うことができます。

🚀 クイックスタート

前提条件

• Node.js 16 以上
• ShipBob API キー（ShipBob コンソールから取得）

インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. ShipBob API キーを含む .env ファイルを作成します。

   SHIPBOB_API_KEY=your_api_key_here
   

サーバーの起動

サーバーを起動します。

npm run dev

MCP チェッカーを使用したテスト

MCP チェッカーを使用してサーバーをテストします。

npm run inspect

これにより、Web インターフェイスが開き、以下の操作が可能です。

• 利用可能なツールとリソースを閲覧する
• カスタム入力を使用してツールをテストする
• サーバーのログとレスポンスを表示する

✨ 主な機能

• 商品：商品カタログを管理します。
• 注文：注文の作成と管理を行います。
• 在庫：在庫レベルの追跡と調整を行います。
• 履行：出荷と履行プロセスを管理します。
• ウェブフック：ShipBob イベントの通知を設定します。
• 返品：返品要求の処理と管理を行います。
• 場所：履行センターの情報を取得します。
• チャネル：販売チャネルを管理します。
• レポート：レポートの生成と取得を行います。

💻 使用例

基本的な使用法

商品管理

# list_products：ShipBob 在庫の商品を一覧表示
list_products

# get_product：特定の商品の詳細情報を取得
get_product

# create_product：新しい商品を作成
create_product

# update_product：既存の商品を更新
update_product

注文管理

# list_orders：ShipBob アカウントの注文を一覧表示
list_orders

# get_order：特定の注文の詳細情報を取得
get_order

# create_order：新しい注文を作成
create_order

# cancel_order：既存の注文をキャンセル
cancel_order

在庫管理

# get_inventory：すべての履行センターの在庫情報を取得
get_inventory

# get_product_inventory：特定の商品の在庫情報を取得
get_product_inventory

# get_inventory_levels：すべての商品の現在の在庫レベルを取得
get_inventory_levels

# adjust_inventory：在庫調整を行う
adjust_inventory

履行

# list_shipments：アカウント内のすべての出荷を一覧表示
list_shipments

# get_shipment：特定の出荷の詳細情報を取得
get_shipment

# create_shipment：新しい出荷を作成
create_shipment

ウェブフック

# list_webhooks：すべての設定済みウェブフックを一覧表示
list_webhooks

# create_webhook：新しいウェブフックを作成
create_webhook

# delete_webhook：既存のウェブフックを削除
delete_webhook

返品

# list_returns：アカウント内のすべての返品を一覧表示
list_returns

# get_return：特定の返品の詳細情報を取得
get_return

# create_return：新しい返品を作成
create_return

場所

# list_fulfillment_centers：すべての履行センターを一覧表示
list_fulfillment_centers

# get_fulfillment_center：特定の履行センターの詳細情報を取得
get_fulfillment_center

チャネル

# list_channels：すべての販売チャネルを一覧表示
list_channels

# get_channel：特定の販売チャネルの詳細情報を取得
get_channel

レポート

# get_inventory_report：在庫レポートを取得
get_inventory_report

# get_orders_report：注文レポートを取得
get_orders_report

# get_shipping_report：出荷レポートを取得
get_shipping_report

📚 ドキュメント

利用可能なリソース

• shipbob://docs/{section}：ShipBob API のドキュメントにアクセスします。
  • 利用可能なセクション：概要、認証、商品、注文、在庫、履行、ウェブフック、返品、場所、チャネル、レポート

📄 ライセンス

MIT