remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Direct integration with Shopify's GraphQL Admin API for querying and mutating store data, with support for complex filtering, pagination, and sorting.
Enables interaction with Shopify store data through the GraphQL Admin API, providing tools for managing products, customers, orders, collections, discounts, webhooks, and accessing shop details.
Utilizes Zod for runtime type validation of API inputs and outputs, ensuring data integrity when interacting with the Shopify API.

Shopify MCPサーバー

Shopify API用のMCPサーバー。GraphQL APIを介してストアデータとのやり取りを可能にします。このサーバーは、商品、顧客、注文などを管理するためのツールを提供します。

特徴

製品管理：製品情報の検索と取得
顧客管理: 顧客データを読み込み、顧客タグを管理する
注文管理：高度な注文照会とフィルタリング
GraphQL 統合: Shopify の GraphQL 管理 API との直接統合
包括的なエラー処理: APIおよび認証の問題に関する明確なエラーメッセージ

ツール

get-products
- すべての製品を取得するか、タイトルで検索してください
- 入力:
  - searchTitle (オプションの文字列): タイトルで製品をフィルタリングします
  - limit (数値): 返される商品の最大数
- 戻り値: タイトル、説明、ハンドル、バリエーションを含むフォーマットされた商品の詳細
get-products-by-collection
- 特定のコレクションから製品を取得する
- 入力:
  - collectionId (文字列): 製品を取得するコレクションのID
  - limit （オプションの数値、デフォルト：10）：返される製品の最大数
- 戻り値: 指定されたコレクションからフォーマットされた製品の詳細
get-products-by-ids
- IDで商品を取得する
- 入力:
  - productIds (文字列の配列): 取得する製品IDの配列
- 戻り値: 指定された商品のフォーマットされた商品詳細
update-product-price
- IDの製品価格を更新する
- 入力:
  - productId (文字列): 更新する製品のID
  - price （文字列）：商品の新しい価格
- 戻り値: 更新の応答
get-variants-by-ids
- IDで商品バリエーションを取得する
- 入力:
  - variantIds (文字列の配列): 取得するバリアントIDの配列
- 返品: 製品の詳細を含む詳細なバリアント情報
get-customers
- ページネーションサポートでShopifyの顧客を獲得
- 入力:
  - limit （オプションの数値）：返される顧客の最大数
  - next (オプションの文字列): 次のページカーソル
- 戻り値: JSON形式の顧客データ
tag-customer
- 顧客にタグを追加する
- 入力:
  - customerId (文字列): タグ付けする顧客ID
  - tags (文字列の配列): 顧客に追加するタグ
- 戻り値: 成功または失敗のメッセージ
get-orders
- 高度なフィルタリングと並べ替えで注文を取得する
- 入力:
  - first （オプションの数字）：返品する注文の制限
  - after (オプション文字列): 次のページカーソル
  - query （オプションの文字列）：クエリ構文を使用して注文をフィルタリングする
  - sortKey (オプションの列挙型): 並べ替えの基準となるフィールド ('PROCESSED_AT'、'TOTAL_PRICE'、'ID'、'CREATED_AT'、'UPDATED_AT'、'ORDER_NUMBER')
  - reverse （オプションのブール値）: 逆順のソート
- 返品: フォーマットされた注文詳細
get-order
- IDで単一の注文を取得する
- 入力:
  - orderId (文字列): 取得する注文のID
- 返品: 詳細な注文情報
create-discount

基本割引コードを作成する
入力:
- title (文字列): 割引のタイトル
- code (文字列): 顧客が入力する割引コード
- valueType (列挙型): 割引の種類 ('percentage' または 'fixed_amount')
- value （数値）：割引値（小数または固定金額のパーセンテージ）
- startsAt (文字列): ISO形式の開始日
- endsAt (オプションの文字列): ISO 形式のオプションの終了日
- appliesOncePerCustomer (boolean): 割引を顧客ごとに1回のみ使用できるかどうか
返品: 作成された割引の詳細

create-draft-order

下書き注文を作成する
入力:
- lineItems (配列): バリアントIDと数量を持つアイテムの配列
- email (文字列): 顧客のメールアドレス
- shippingAddress (オブジェクト): 配送先住所の詳細
- note （オプションの文字列）：注文に関するオプションのメモ
返品: ドラフト注文の詳細を作成しました

complete-draft-order

ドラフト注文を完了する
入力:
- draftOrderId (文字列): 完了する下書き注文のID
- variantId (文字列): ドラフト注文内のバリアントのID
返品: 完了した注文の詳細

get-collections

すべてのコレクションを取得
入力:
- limit （オプションの数値、デフォルト：10）：返されるコレクションの最大数
- name (オプションの文字列): 名前でコレクションをフィルタリングする
返品：コレクションの詳細

get-shop

ショップの詳細を見る
入力: なし
返品について：店舗基本情報

get-shop-details

配送国を含むショップの詳細情報を入手
入力: なし
返品: 配送国を含むショップの詳細情報

manage-webhook

Webhook を登録、検索、登録解除する
入力:
- action (列挙型): 実行するアクション ('subscribe'、'find'、'unsubscribe')
- callbackUrl (文字列): WebhookコールバックURL
- topic (enum): サブスクライブするWebhookトピック
- webhookId (オプションの文字列): Webhook ID (登録解除に必須)
戻り値: Webhook の詳細または成功メッセージ

設定

Shopifyアクセストークン

この MCP サーバーを使用するには、Shopify ストアでカスタムアプリを作成する必要があります。

Shopify管理画面から、 「設定」 > **「アプリと販売チャネル」**に移動します。
**「アプリを開発」**をクリックします（最初に開発者プレビューを有効にする必要がある場合があります）
アプリを作成をクリック
アプリの名前を設定します（例：「Shopify MCP Server」）
管理APIスコープの設定をクリックします
次のスコープを選択します。
- read_products 、 write_products
- read_customers 、 write_customers
- read_orders 、 write_orders
保存をクリック
アプリをインストールをクリック
インストールをクリックすると、アプリがストアデータにアクセスできるようになります
インストール後、管理APIアクセストークンが表示されます。
このトークンをコピーしてください - 設定に必要になります

注：アクセストークンは安全に保管してください。ストアデータへのアクセスを許可するトークンであり、共有したりバージョン管理にコミットしたりしないでください。Shopifyアプリの作成方法の詳細については、こちらをご覧ください。

Claude Desktopでの使用

claude_desktop_config.jsonに追加します:

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["-y", "shopify-mcp-server"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "MYSHOPIFY_DOMAIN": "<YOUR_SHOP>.myshopify.com"
      }
    }
  }
}

発達

リポジトリをクローンする
依存関係をインストールします:

npm install

.envファイルを作成します。

SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.com

プロジェクトをビルドします。

npm run build

テストを実行します:

npm test

依存関係

@modelcontextprotocol/sdk - MCP プロトコルの実装
graphql-request - Shopify API 用の GraphQL クライアント
zod - ランタイム型検証

貢献

貢献を歓迎します！まずは貢献ガイドラインをお読みください。

ライセンス

マサチューセッツ工科大学

コミュニティ

モデルコンテキストプロトコルを使用して❤️で構築

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

GraphQL API を介して Shopify ストアとのやり取りを可能にし、製品、顧客、注文などを管理するためのツールを提供します。