Shopify Store MCP Server

Shopify商店MCP服务器

连接到的模型上下文协议（MCP）服务器 Shopify商店直播 通过管理和店面API。与仅记录MCP不同，此服务器使AI代理能够执行 实际操作 在你的商店。

为什么选择MCP？

重要提示： 为了获得最佳体验，请使用 两者 这个MCP和官方 Shopify开发MCP 一起。Dev MCP帮助您的AI代理了解Shopify的API架构和文档，同时此MCP执行您商店的实际操作。

特性

• 通用GraphQL访问 -通过执行任何管理API查询或突变 run_graphql_query
• 智能多步工具 --文件上传、批量操作、元对象异常以及自动轮询
• 速率限制 --尊重Shopify基于计划的费率限制（标准/高级/高级/企业）
• 操作日志 --SQLite数据库跟踪调试和历史记录的所有操作
• 架构发现 --探索您商店的图元字段定义和图元对象类型

先决条件

1. Node.js 18+
2. Shopify商店 带着一个 自定义应用程序
3. 管理员API访问令牌 --在Shopify Admin中创建自定义应用程序→ 设置→ 应用程序和开发渠道→ 开发应用程序

安装

Cursor

快速安装

安装后，编辑配置以添加实际的存储凭据。

手动配置

添加到光标MCP设置(~/.cursor/mcp.json):

{
  "mcpServers": {
    "shopify-store-mcp": {
      "command": "npx",
      "args": ["-y", "shopify-store-mcp"],
      "env": {
        "SHOPIFY_STORE_URL": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Windows Configuration

{
  "mcpServers": {
    "shopify-store-mcp": {
      "command": "cmd",
      "args": ["/k", "npx", "-y", "shopify-store-mcp"],
      "env": {
        "SHOPIFY_STORE_URL": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude Desktop

添加到您的Claude Desktop配置中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "shopify-store-mcp": {
      "command": "npx",
      "args": ["-y", "shopify-store-mcp"],
      "env": {
        "SHOPIFY_STORE_URL": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Windows Configuration

{
  "mcpServers": {
    "shopify-store-mcp": {
      "command": "cmd",
      "args": ["/k", "npx", "-y", "shopify-store-mcp"],
      "env": {
        "SHOPIFY_STORE_URL": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude Code (CLI)

添加到您的克劳德代码设置(~/.claude/settings.json):

{
  "mcpServers": {
    "shopify-store-mcp": {
      "command": "npx",
      "args": ["-y", "shopify-store-mcp"],
      "env": {
        "SHOPIFY_STORE_URL": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

VS Code (Copilot)

添加到您的VS代码设置(settings.json):

{
  "mcp.servers": {
    "shopify-store-mcp": {
      "command": "npx",
      "args": ["-y", "shopify-store-mcp"],
      "env": {
        "SHOPIFY_STORE_URL": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Windsurf

添加到您的Windsurf MCP配置(~/.windsurf/mcp.json):

{
  "mcpServers": {
    "shopify-store-mcp": {
      "command": "npx",
      "args": ["-y", "shopify-store-mcp"],
      "env": {
        "SHOPIFY_STORE_URL": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Other MCP Clients

对于任何兼容MCP的客户端，请使用：

npx -y shopify-store-mcp

对于环境变量：

• SHOPIFY_STORE_URL --您店铺的myshopify.com域名
• SHOPIFY_ACCESS_TOKEN -管理员API访问令牌

推荐：添加Shopify开发MCP

为了获得最佳的AI代理体验，还添加了官方 Shopify开发MCP它提供：

• API文档搜索
• GraphQL模式自检
• 查询验证
• 最新的Shopify API知识

这有助于您的AI代理了解 写什么查询 在使用此MCP执行它们之前。

{
  "mcpServers": {
    "shopify-store-mcp": {
      "command": "npx",
      "args": ["-y", "shopify-store-mcp"],
      "env": {
        "SHOPIFY_STORE_URL": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
      }
    },
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@shopify/dev-mcp@latest"]
    }
  }
}

环境变量

可用工具

核心工具

智能工具

自动处理复杂性的多步骤工作流：

基础设施工具

速率限制

服务器会根据您的店铺计划自动遵守Shopify的费率限制：

使用 configure 该工具用于设置您的等级或从您的店铺计划中自动检测。

可用提示

可用资源

发展

# Clone the repo
git clone https://github.com/Brahim-Benzarti/Shopify_store-MCP.git
cd Shopify_store-MCP

# Install dependencies
npm install

# Build
npm run build

# Run with MCP Inspector
npm run inspect

# Watch mode
npm run dev

# View database
npm run db:studio

数据库

服务器使用SQLite进行操作日志记录和配置。数据库在以下位置自动创建 ~/.shopify-mcp/mcp.db.

安全

• 永不承诺 你的 .env 文件或访问令牌
• 使用 环境变量 或MCP配置以获取凭据
• 访问令牌应具有 所需最小范围
• 操作在本地记录以进行调试（禁用 MCP_LOG_OPERATIONS=false)

许可证

国际学生委员会

相关

• Shopify开发MCP -API官方Shopify MCP文档
• Shopify管理员API -GraphQL API参考
• 模型上下文协议 --MCP规范