MCP 服务器

Shopify MCP Server

Tools

get-products

Get all products or search by title

get-products-by-collection

Get products from a specific collection

get-orders

Get shopify orders with advanced filtering and sorting

get-products-by-ids

Get products by their IDs

get-variants-by-ids

Get product variants by their IDs

get-customers

Get shopify customers with pagination support

tag-customer

Add tags to a customer

get-order

Get a single order by ID

create-discount

Create a basic discount code

create-draft-order

Create a draft order

complete-draft-order

Complete a draft order

get-collections

Get all collections

get-shop

Get shop details

get-shop-details

Get extended shop details including shipping countries

manage-webhook

Subscribe, find, or unsubscribe webhooks

README

<div align="center"> <h1>Shopify MCP Server</h1> <p><strong>GraphQL-powered integration with Shopify Admin API</strong></p> <p> <a href="https://example.com/build-status"><img src="https://img.shields.io/badge/build-passing-brightgreen" alt="Build Status"></a> <a href="https://www.npmjs.com/package/shopify-mcp-server"><img src="https://img.shields.io/badge/npm-1.0.1-blue" alt="npm version"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License"></a> <a href="https://discord.gg/kR2DFxV8"><img src="https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&logoColor=white" alt="Discord"></a> </p> </div>

🚀 Overview

Shopify MCP Server provides a powerful bridge between your applications and the Shopify ecosystem through the Model Context Protocol. Easily manage products, customers, orders, and more with simple API calls to Shopify's Admin API.

📥 Installation

Choose your preferred installation method:

Method	Instructions
Smithery
Glama.ai
NPM	`npm install shopify-mcp-server`

✨ Features

🛍️ Comprehensive Product Management - Search, retrieve, and manage product data
👥 Customer Data Access - Get customer information and manage tags
📦 Advanced Order Processing - Filter, sort, and manage orders easily
⚡ Direct GraphQL Integration - Connect directly to Shopify's Admin API
🛡️ Robust Error Handling - Clear feedback for troubleshooting

🧰 Available Tools

Product Management

Tool	Description	Key Parameters
`get-products`	Find products by title	`searchTitle`, `limit`
`get-products-by-collection`	Get collection products	`collectionId`, `limit`
`get-products-by-ids`	Retrieve specific products	`productIds`
`get-variants-by-ids`	Get variant details	`variantIds`

Customer Management

Tool	Description	Key Parameters
`get-customers`	Retrieve customer data	`limit`, `next`
`tag-customer`	Add tags to customers	`customerId`, `tags`

Order Management

Tool	Description	Key Parameters
`get-orders`	Filter and sort orders	`first`, `after`, `query`, `sortKey`
`get-order`	Get single order details	`orderId`

Shop & Collection Tools

Tool	Description	Key Parameters
`get-collections`	Retrieve shop collections	`limit`, `name`
`get-shop`	Get basic shop details	None
`get-shop-details`	Get extended shop info	None

Discount Management

Tool	Description	Key Parameters
`create-discount`	Create discount codes	`title`, `code`, `valueType`, `value`

🏁 Getting Started

Install the package
```
npm install shopify-mcp-server
```

Set up environment variables

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

Initialize the server
```
require('shopify-mcp-server').start();
```

Make your first API call

const products = await shopifyMcpServer.tools.getProducts({ limit: 10 });
console.log(products);

💡 Use Cases

E-commerce Platform Integration - Sync products and orders between systems
Custom Admin Dashboards - Build tailored interfaces for your business needs
Order Automation - Set up workflows for automatic order processing
Multi-channel Sales Management - Manage inventory across all sales channels

🔧 Setup Guide

Getting a Shopify Access Token

From your Shopify admin, go to Settings > Apps and sales channels
Click Develop apps > Create an app
Name your app (e.g., "Shopify MCP Server")
Configure API scopes:
- read_products, write_products
- read_customers, write_customers
- read_orders, write_orders
Click Save and Install app
Copy your Admin API access token

Security Note: Store your access token securely. Never commit it to version control.

Using with Claude Desktop

Add to your claude_desktop_config.json:

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

👨‍💻 Development

# Clone the repository
git clone https://github.com/your-username/shopify-mcp-server.git

# Install dependencies
cd shopify-mcp-server
npm install

# Set up environment variables
# Create a .env file with your Shopify credentials

# Build and test
npm run build
npm test