MMCPMarkets
CS

cesarjoquin/shopify-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

143 stars 400 forks Качество 84 Тренд 24MIT
Repository Install

shopify mcp server для Claude Desktop, Claude Code или любого совместимого с MCP клиентом для управления продуктами, клиентами, заказами, запасами и метаполями через типизированный интерфейс Shopify MCP

Обзор

Ориентированный на производство сервер Model Context Protocol, который предоставляет API Shopify Admin GraphQL для ассистентов ИИ. Подключите Claude Desktop, Claude Code или любой совместимый с MCP клиент для управления продуктами, клиентами, заказами, запасами и метаполями через типизированный инструментальный интерфейс. Этот сервер преобразует вызовы инструментов MCP в операции Shopify Admin GraphQL. Он поддерживает статические токены доступа и учетные данные OAuth (приложения Dev Dashboard), опциональное сохранение токенов с поддержкой Redis, структурированное ведение JSON и плавное отключение. Все инструменты списка поддерживают пагинацию курсора, сортировку и фильтрацию синтаксиса поиска в Shopify. - 18 или выше — с пользовательским приложением и областью управления API — (опционально) для сохранения токена OAuth при перезапусках read_products, write_products, read_customers, write_customers, read_orders, write_orders (плюс скопы для инвентаря/метаполей по необходимости). Расположения конфигурации: - ~/Library/Application Support/Claude/claude_desktop_config.json - %APPDATA%/Claude/claude_desktop_config.

Обзор (машинный перевод)

Ориентированный на производство сервер Model Context Protocol, который предоставляет API Shopify Admin GraphQL для ассистентов ИИ. Подключите Claude Desktop, Claude Code или любой совместимый с MCP клиент для управления продуктами, клиентами, заказами, запасами и метаполями через типизированный инструментальный интерфейс.

Содержание

  • Обзор
  • Архитектура
  • Особенности
  • Требования
  • Установка
  • Конфигурация
  • Разработка
  • Тестирование
  • Структура проекта
  • Устранение неисправностей
  • Вклад
  • FAQ
  • Лицензия

Обзор

Этот сервер преобразует вызовы инструментов MCP в операции Shopify Admin GraphQL. Он поддерживает статические токены доступа и учетные данные OAuth (приложения Dev Dashboard), опциональное сохранение токенов с поддержкой Redis, структурированное ведение JSON и плавное отключение.

Архитектура

Слои во время выполнения

Слой Ответственность
src/index.ts Запись процесса, граница ошибки
src/server/ Bootstrap, проводка MCP, выключающие крючки
src/config/ Окружение и конфигурация CLI
src/lib/ Аутентификация, логирование, Redis, общие коммунальные услуги
src/tools/ 40 инструментов MCP (продукты, заказы, клиенты, …)

Рабочий процесс запроса

Процесс аутентификации

Особенности

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Shopify MCP Server

A production-oriented Model Context Protocol server that exposes the Shopify Admin GraphQL API to AI assistants. Connect Claude Desktop, Claude Code, or any MCP-compatible client to manage products, customers, orders, inventory, and metafields through a typed tool interface.

Table of Contents

Overview

This server translates MCP tool calls into Shopify Admin GraphQL operations. It supports static access tokens and OAuth client-credentials (Dev Dashboard apps), optional Redis-backed token persistence, structured JSON logging, and graceful shutdown.

flowchart LR
  Client[MCP Client] -->|stdio JSON-RPC| Server[MCP Server]
  Server --> Tools[Tool Registry]
  Tools --> GraphQL[Shopify Admin GraphQL]
  Server --> Auth[OAuth Token Manager]
  Auth --> Redis[(Redis Cache)]
  Auth --> GraphQL

Architecture

Runtime layers

Layer Responsibility
src/index.ts Process entry, error boundary
src/server/ Bootstrap, MCP wiring, shutdown hooks
src/config/ Environment and CLI configuration
src/lib/ Auth, logging, Redis, shared utilities
src/tools/ 40 MCP tools (products, orders, customers, …)

Request workflow

sequenceDiagram
  participant C as MCP Client
  participant M as McpServer
  participant T as Tool
  participant S as Shopify API

  C->>M: tools/call
  M->>T: execute(args)
  T->>T: Zod schema validation
  T->>S: GraphQL request
  S-->>T: Response
  T-->>M: Formatted JSON
  M-->>C: MCP content block

Authentication flow

sequenceDiagram
  participant S as Server
  participant R as Redis
  participant SH as Shopify OAuth

  S->>R: Check cached token
  alt Valid cache hit
    R-->>S: access_token
  else Cache miss
    S->>SH: client_credentials grant
    SH-->>S: access_token + expires_in
    S->>R: Store token with TTL
  end
  Note over S: Auto-refresh 5 min before expiry

Features

Category Capabilities
Products CRUD, variants, options, collections
Customers CRUD, merge, address management
Orders Query, cancel, fulfill, refund, draft orders
Metafields Read, write, delete on any resource
Inventory Set quantities, read levels and items
Discovery Shop info, locations, markets, price lists
Platform Redis token cache, structured logging, graceful shutdown, strict TypeScript

All list tools support cursor pagination, sorting, and Shopify search syntax filtering.

Открыть полный README на GitHub

Установка

npx shopify-mcp --clientId <CLIENT_ID> --clientSecret <CLIENT_SECRET> --domain <store>.myshopify.com
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "shopify": { "command": "npx", "args": [ "shopify-mcp", "--clientId", "<CLIENT_ID>", "--clientSecret", "<CLIENT_SECRET>", "--domain", "<store>.myshopify.com" ] } } }