Siddhantbajaj Shopify MCP Server

🚀 Shopify MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を利用して、クライアント（Claudeなど）をShopifyストアのデータに接続するためのものです。Shopifyストアから商品や顧客情報を取得するためのツールを提供します。

✨ 主な機能

• get-product-list：Shopifyストアから商品リストを取得します。
• get-customer-list：Shopifyストアから顧客リストを取得します。
• さらなる機能が追加予定です。

📦 インストール

前提条件

• Python 3.12以上
• APIアクセス権限を持つShopifyストア
• Shopify APIの認証情報（APIキー、パスワード、アクセストークン）

インストール手順

1. リポジトリをクローンします。

git clone https://github.com/siddhantbajaj/shopify-mcp-server.git
cd shopify-mcp-server

2. uvを使用して仮想環境を作成し、アクティブ化します。

uv venv
source .venv/bin/activate  # Unix/MacOSの場合
# または
.venv\Scripts\activate  # Windowsの場合

3. パッケージをインストールします。

uv pip install -e .

📚 ドキュメント

設定

1. ルートディレクトリに.envファイルを作成し、Shopifyの認証情報を追加します。

SHOPIFY_SHOP_URL="your-store.myshopify.com"
SHOPIFY_API_KEY="your_api_key"
SHOPIFY_PASSWORD="your_api_password"
SHOPIFY_ACCESS_TOKEN="your_access_token"

プレースホルダーの値を実際のShopify APIの認証情報に置き換えてください。

使用方法

1. MCPサーバーを起動します。

python -m shopify_mcp_server.server

2. サーバーは2つのツールを公開しています。

get-product-list

Shopifyストアから商品リストを取得します。

• オプションパラメータ: limit（デフォルト値は10）- 返される商品の最大数

get-customer-list

Shopifyストアから顧客リストを取得します。

• オプションパラメータ: limit（デフォルト値は10）- 返される顧客の最大数

ツールの応答形式

商品

商品 (表示 X):

タイトル: 商品名称
ID: 123456789
タイプ: タイプ
サプライヤー: サプライヤー名称
ステータス: active
価格: $XX.XX
---

顧客

顧客 (表示 X):

名前: ジョン・ドウ
ID: 123456789
メールアドレス: john@example.com
注文数: X
総消費金額: $XX.XX
---

開発

このプロジェクトは以下を使用しています。

• MCP（モデルコンテキストプロトコル）：AI駆動のツールを構築するため
• Shopify Python API：Shopifyとの統合
• UV：依存関係の管理

セキュリティ

• .envファイルをバージョン管理にコミットしないでください。
• Shopify APIの認証情報を安全に保管してください。
• 環境変数を使用して機密情報を保存してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細については、LICENSEファイルを参照してください。

貢献の方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）。
3. 変更をコミットします（git commit -m '素敵な機能を追加'）。
4. ブランチにプッシュします（git push origin feature/amazing-feature）。
5. Pull Requestを作成します。