Shopify MCP Server

🚀 Shopify MCP サーバー

このサーバーは、Model Context Protocol (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 の認証情報に置き換えてください。

💻 使用例

サーバーの起動

python -m shopify_mcp_server.server

提供されるツール

get-product-list

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

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

get-customer-list

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

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

ツールの応答形式

商品

商品（表示 X 個）：

タイトル：商品名称
ID：123456789
タイプ：タイプ
サプライヤー：サプライヤー名称
ステータス：アクティブ
価格：$XX.XX
---

顧客

顧客（表示 X 個）：

名前：ジョン・Doe
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 'Add some amazing feature'）。
4. ブランチにプッシュします（git push origin feature/amazing-feature）。
5. プルリクエストを作成します。