AM

asaricorp/mcp-shopify

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

9 stars 5 forks 质量 65 趋势 17MIT

MCP Server for Shopify API, enabling interaction with store data through GraphQL API. This server provides tools for managing products, customers, orders, and more.

概览

MCP Server for Shopify API, enabling interaction with store data through GraphQL API. This server provides tools for managing products, customers, orders, and more. - : Search and retrieve product information - : Load customer data and manage customer tags - : Advanced order querying and filtering - : Create and manage collections To use this MCP server, you'll need to create a custom app in your Shopify store: 1. From your Shopify admin, go to > 2. Click (you may need to enable developer preview first) 3. Click 4. Set a name for your app (e.g., "Shopify MCP Server") 5. Click 6. Select the following scopes: - read_products, write_products - read_customers, write_customers - read_orders, write_orders - read_collections, write_collections 7. Click 8. Click 9. Click to give the app access to your store data 10. After installation, you'll see your 11. Copy this token - you'll need it for configuration Add this to your claude_desktop_config.

README

以下为原文 README 节选,完整内容请查看原文。

Shopify MCP Server

MCP Server for Shopify API, enabling interaction with store data through GraphQL API. This server provides tools for managing products, customers, orders, and more.

Features

  • Product Management: Search and retrieve product information
  • Customer Management: Load customer data and manage customer tags
  • Order Management: Advanced order querying and filtering
  • Collection Management: Create and manage collections

Setup

Shopify Access Token

To use this MCP server, you’ll need to create a custom app in your Shopify store:

  1. From your Shopify admin, go to Settings > Apps and sales channels
  2. Click Develop apps (you may need to enable developer preview first)
  3. Click Create an app
  4. Set a name for your app (e.g., “Shopify MCP Server”)
  5. Click Configure Admin API scopes
  6. Select the following scopes:
    • read_products, write_products
    • read_customers, write_customers
    • read_orders, write_orders
    • read_collections, write_collections
  7. Click Save
  8. Click Install app
  9. Click Install to give the app access to your store data
  10. After installation, you’ll see your Admin API access token
  11. Copy this token - you’ll need it for configuration

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-mcp",
        "--accessToken",
        "",
        "--domain",
        ".myshopify.com"
      ]
    }
  }
}

Locations for the Claude Desktop config file:

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json

Alternative: Run Locally with Environment Variables

If you prefer to use environment variables instead of command-line arguments:

  1. Create a .env file with your Shopify credentials:

    SHOPIFY_ACCESS_TOKEN=your_access_token
    MYSHOPIFY_DOMAIN=your-store.myshopify.com
    
  2. Run the server with npx:

    npx shopify-mcp
    

Direct Installation (Optional)

If you want to install the package globally:

npm install -g shopify-mcp

Then run it:

shopify-mcp --accessToken= --domain=.myshopify.com

Available Tools

Product Management

  1. get-products

    • Get all products or search by title
    • Inputs:
      • searchTitle (optional string): Filter products by title
      • limit (number): Maximum number of products to return
  2. get-product-by-id

    • Get a specific product by ID
    • Inputs:
      • productId (string): ID of the product to retrieve

Customer Management

  1. get-customers

    • Get customers or search by name/email
    • Inputs:
      • searchQuery (optional string): Filter customers by name or email
      • limit (optional number, default: 10): Maximum number of customers to return
在 GitHub 查看完整 README

安装

npx shopify-mcp --accessToken <YOUR_ACCESS_TOKEN> --domain <YOUR_SHOP>.myshopify.com
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "shopify": { "command": "npx", "args": [ "shopify-mcp", "--accessToken", "<YOUR_ACCESS_TOKEN>", "--domain", "<YOUR_SHOP>.myshopify.com" ] } } }