Shopify Admin GraphQL MCP Server

Shopify Admin GraphQL MCP サーバー

Shopify の Admin GraphQL API と連携するための、包括的な Model Context Protocol（MCP）サーバーです。このサーバーは、商品、注文、顧客、在庫、ディスカウント、メタフィールド、ショップ情報を管理するためのツールとリソースを提供します。

## 特長

- Shopify Admin API の主要機能を網羅
- Shopify の主要なすべてのリソースに対応した構造化ツール
- API の各セクションに関するドキュメントリソース
- MCP 対応クライアントで簡単に利用可能

## セットアップ

1. このリポジトリをクローンします
2. 依存関係をインストールします：
   ```
   npm install
   ```
3. Shopify の認証情報を記述した `.env` ファイルを作成します：
   ```
   SHOPIFY_SHOP_NAME=your-shop-name
   SHOPIFY_ACCESS_TOKEN=your-access-token
   ```

## 使い方

サーバーを起動します：
```
npm run dev
```

MCP Inspector でテストします：
```
npm run inspect
```

## 利用可能なツール

### 商品
- getProduct：ID で商品を取得します
- listProducts：ページネーションを使用して商品を一覧表示します
- createProduct：新しい商品を作成します
- updateProduct：既存の商品を更新します
- deleteProduct：商品を削除します

### 注文
- getOrder：ID で注文を取得します
- listOrders：ページネーションを使用して注文を一覧表示します
- cancelOrder：注文をキャンセルします

### 顧客
- getCustomer：ID で顧客を取得します
- listCustomers：ページネーションを使用して顧客を一覧表示します
- createCustomer：新しい顧客を作成します
- updateCustomer：既存の顧客を更新します
- deleteCustomer：顧客を削除します

### 在庫
- getInventoryItem：ID で在庫アイテムを取得します
- adjustInventory：在庫数を調整します
- getInventoryLevel：ロケーションとアイテムの在庫数を取得します

### ディスカウント
- getDiscount：ID でディスカウントを取得します
- createDiscount：基本的なディスカウントコードを作成します
- deleteDiscount：ディスカウントを削除します

### メタフィールド
- getMetafield：ID でメタフィールドを取得します
- createProductMetafield：商品用のメタフィールドを作成します
- deleteMetafield：メタフィールドを削除します

### ショップ
- getShopInfo：ショップ情報を取得します
- updateShopInfo：ショップ情報を更新します

## ドキュメントリソース

`shopify://docs/{section}` リソースを使用してドキュメントにアクセスできます。section に指定できる値は次のとおりです：
- overview
- products
- orders
- customers
- inventory
- discounts
- metafields
- shop

## 認証

このサーバーを使用するには、Shopify Admin API のアクセストークンが必要です。Shopify 管理画面の「アプリ」>「アプリを開発」から作成できます。