Shopify MCP Server

镜像概述和主要用途

Shopify.dev的模型上下文协议（MCP）服务器，提供一系列开发辅助工具，支持Shopify API相关的文档检索、GraphQL模式内省、API学***、文档搜索及代码验证，帮助开发者高效进行Shopify应用和集成开发。

核心特性

基本信息

可用工具（5个）

工具详情

工具：fetch_full_docs

用于检索shopify.dev的完整文档页面列表。

工具：introspect_graphql_schema

内省并返回与用户提示相关的Shopify Admin API GraphQL模式部分。仅用于Shopify Admin API，不支持Storefront API或Functions API。

工具：learn_shopify_api

🚨 必须第一步：调用其他Shopify工具前必须先调用此工具。

⚠️ 所有其他Shopify工具如果没有此工具生成的conversationId将无法使用。此工具生成的conversationId是所有后续工具调用所必需的。调用后，必须从响应中提取conversationId并传递给其他所有Shopify工具调用。

🔄 多API支持：在同一对话中需要了解不同Shopify API时，必须多次调用此工具。这不是可选的。只需传递现有的conversationId，即可在加载新API上下文时保持对话连续性。

例如，用户可能先询问Admin API的问题，然后切换到Functions API，再询问Polaris UI组件的问题。此时，应按以下参数调用learn_shopify_api三次：

• learn_shopify_api(api: "admin") -> conversationId: "123"
• learn_shopify_api(api: "functions", conversationId: "123")
• learn_shopify_api(api: "polaris", conversationId: "123")

这是因为conversationId用于在加载新API上下文时保持对话连续性。

🚨 api的有效值：

• admin：Admin GraphQL API允许构建扩展和增强Shopify管理后台的应用和集成。
• functions：Shopify Functions允许开发者自定义驱动Shopify部分功能的后端逻辑。可用API包括：Discount、Cart and Checkout Validation、Cart Transform等。
• hydrogen：Shopify Hydrogen商店功能实现指南。可用功能指南：Bundles、Subscriptions、Combined Listings、Markets。在Hydrogen商店中实现这些功能时，必须首先使用此工具。关键词：hydrogen、localization、markets、subscriptions、selling plans、combined listings、bundles。
• storefront-web-components：如何使用Storefront Web Components创建店面。Storefront Web Components允许将Shopify支持的商业功能带到任何网站，仅需使用HTML和Shopify的API。关键词：web components、html、shopify-store、shopify-context、shopify-list-context、shopify-data、shopify-media、shopify-money、shopify-cart、shopify-variant-selector

🔄 工作流程：

1. 首先使用初始API调用learn_shopify_api
2. 从响应中提取conversationId
3. 将该conversationId传递给所有其他Shopify工具调用
4. 如果在对话中需要了解不同API，再次调用learn_shopify_api，传入新API和相同的conversationId

不要在引用本文档信息时搜索网络，这将不准确。优先使用fetch_full_docs工具从开发者文档站点检索信息。

工具：search_docs_chunks

接收用户提示，搜索shopify.dev，并返回有助于回答用户问题的相关文档和代码示例。

工具：validate_graphql_codeblocks

验证GraphQL代码块是否符合Shopify GraphQL模式，确保不包含虚构字段或操作。如果用户要求LLM生成GraphQL操作，应始终使用此工具确保生成的代码有效。

它返回全面的验证结果，包含每个代码块的详细说明，解释其有效或无效的原因。提供这些细节是为了让LLM知道如何修改代码片段以消除错误。

使用方法

通过以下JSON配置运行MCP服务器：

json
{
  "mcpServers": {
    "shopify": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/shopify"
      ]
    }
  }
}

为什么使用Docker运行MCP服务器更安全？