colbymchenry/shopify-graphql-admin-mcp

开发工具

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

21 stars 4 forks 质量 59 趋势 10

Repository Install

将Claude连接到您的Shopify商店，解锁Claude的全部功能。

概览

MCP 服务器提供对 Shopify 管理 GraphQL API 的完全访问权限。启动时会内省实时模式，确保始终与最新 API 版本保持更新——没有陈旧文档，无需嵌入。 - — 对管理 API 运行任何查询或变异 - — 直接从 AI 助手搜索和探索完整的 GraphQL 模式（2,700+ 类型） - — 产品、集合、元对象、元字段、客户、订单和库存的类型化、无需 GraphQL 的 CRUD - — 支持 OAuth 客户端凭证（新的开发仪表盘应用）和遗留访问令牌（shpat_） - OAuth 令牌在过期前会自动刷新在你的应用中配置这些示波器，以启用所有工具：你只需要为你打算使用的工具设置作用域。至少要让模式内省和原始GraphQL工作，至少需要一个读取范围。对于在 Shopify 开发者仪表盘中创建的应用： 1. 在开发者仪表盘中创建应用 2.配置上述管理API范围 3.

概述（AI 翻译）

MCP 服务器提供对 Shopify 管理 GraphQL API 的完全访问权限。启动时会内省实时模式，确保始终与最新 API 版本保持更新——没有陈旧文档，无需嵌入。

特色

原始GraphQL执行 — 对管理员API运行任何查询或变异
实时模式内省 — 直接从你的AI助手搜索并探索完整的GraphQL模式（2,700+类型）
29 便利工具 — 用于产品、集合、元对象、元字段、客户、订单和库存的类型化、无需 GraphQL 的 CRUD
双重认证 — 支持OAuth客户端凭证（新的开发仪表盘应用）和遗留访问令牌（shpat_）
自动令牌刷新 — OAuth 令牌在过期前会自动刷新

快速启动

工具

核心

工具	描述
`shopify_graphql`	执行任何原始的GraphQL查询或变异
`shopify_schema_search`	通过关键词（类型、查询、突变）搜索活模式
`shopify_schema_details`	获取特定类型、查询或突变的完整详细信息

产品

工具	描述

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

README

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

shopify-graphql-admin-mcp

MCP server providing full access to Shopify’s Admin GraphQL API. Introspects the live schema on startup so it’s always up-to-date with the latest API version — no stale docs, no embeddings needed.

Features

Raw GraphQL execution — run any query or mutation against the Admin API
Live schema introspection — search and explore the full GraphQL schema (2,700+ types) directly from your AI assistant
29 convenience tools — typed, no-GraphQL-needed CRUD for products, collections, metaobjects, metafields, customers, orders, and inventory
Dual auth — supports both OAuth client credentials (new Dev Dashboard apps) and legacy access tokens (shpat_)
Auto token refresh — OAuth tokens are refreshed automatically before expiry

Quick Start

# With a legacy access token
npx shopify-graphql-admin-mcp --store mystore.myshopify.com --access-token shpat_xxxxx

# With OAuth client credentials (Dev Dashboard app)
npx shopify-graphql-admin-mcp --store mystore.myshopify.com --client-id YOUR_ID --client-secret YOUR_SECRET

Tools

Core

Tool	Description
`shopify_graphql`	Execute any raw GraphQL query or mutation
`shopify_schema_search`	Search the live schema by keyword (types, queries, mutations)
`shopify_schema_details`	Get full details for a specific type, query, or mutation

Products

Tool	Description
`shopify_products_list`	List/search products with pagination
`shopify_product_get`	Get product by ID with variants and metafields
`shopify_product_create`	Create a new product
`shopify_product_update`	Update an existing product
`shopify_product_delete`	Delete a product

Collections

Tool	Description
`shopify_collections_list`	List/search collections with pagination
`shopify_collection_get`	Get collection by ID with products
`shopify_collection_create`	Create a collection (manual or smart)
`shopify_collection_update`	Update a collection
`shopify_collection_delete`	Delete a collection

Metaobjects

Tool	Description
`shopify_metaobject_definitions_list`	List all metaobject type definitions
`shopify_metaobjects_list`	List entries of a specific metaobject type
`shopify_metaobject_get`	Get a single metaobject entry
`shopify_metaobject_create`	Create a new metaobject entry
`shopify_metaobject_update`	Update an existing metaobject entry
`shopify_metaobject_delete`	Delete a metaobject entry

Metafields

Tool	Description
`shopify_metafields_list`	List metafields on any resource
`shopify_metafields_set`	Set (upsert) metafields on any resource
`shopify_metafield_delete`	Delete a metafield

Customers

Tool	Description

在 GitHub 查看完整 README

安装

npx shopify-graphql-admin-mcp --store mystore.myshopify.com --access-token shpat_xxxxx

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-graphql-admin-mcp",
        "--store", "mystore.myshopify.com",
        "--access-token", "shpat_xxxxx"
      ]
    }
  }
}