Shopify Dev MCP Server

Shopify Dev MCP Server 是一个专为 Shopify 开发者设计的模型上下文协议（MCP）服务器，旨在通过 Cursor 或 Claude 等开发工具，直接访问 Shopify 开发文档和 GraphQL 模式，从而提升开发效率。该服务支持文档搜索、GraphQL 模式内省以及提示辅助功能，帮助开发者快速构建和调试 Shopify Admin API 请求。

核心功能

Shopify Dev MCP Server 提供了以下核心功能，帮助开发者更高效地进行 Shopify 开发：

• 文档搜索：允许开发者在开发工具中直接搜索 Shopify 官方开发文档，快速定位所需 API 参考。
• GraphQL 模式内省：提供对 Shopify Admin GraphQL 模式的访问和搜索功能，帮助开发者构建准确的 GraphQL 查询。
• 提示辅助：提供专门的提示模板，辅助开发者编写 Shopify Admin API 的 GraphQL 操作。

这些功能使得开发者无需离开当前开发环境，即可完成文档查阅和 API 构建，显著提升开发效率。

安装方法

Shopify Dev MCP Server 可以通过 npx 命令直接运行，无需额外安装。以下是安装和配置的详细步骤：

npx -y @shopify/dev-mcp@latest

对于 Windows 用户，可能需要特殊配置以确保命令正确执行：

{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "cmd",
      "args": ["/k", "npx", "-y", "@shopify/dev-mcp@latest"]
    }
  }
}

开发者也可以将此配置添加到 Cursor 或 Claude Desktop 的 MCP 服务器配置中，以便在开发工具中直接使用。

使用方法

Shopify Dev MCP Server 提供了多种命令和提示，帮助开发者快速完成文档搜索和 GraphQL 查询构建。

以下是两个典型使用场景：

1. 搜索 Shopify 开发文档

search_dev_docs

该命令允许开发者输入关键词，搜索 Shopify 官方开发文档。例如，输入“订单API创建方法”将返回相关文档内容。

2. 内省 Shopify Admin GraphQL 模式

introspect_admin_schema

该命令用于访问和搜索 Shopify Admin GraphQL 模式，帮助开发者构建正确的 GraphQL 查询。例如，输入“如何查询前10个产品的id和title?”将返回相应的 GraphQL 查询结构。

开发者还可以通过以下配置将 MCP 服务器集成到开发工具中：

{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@shopify/dev-mcp@latest"]
    }
  }
}

使用场景

Shopify Dev MCP Server 适用于以下开发场景：

• 需要快速查阅 Shopify 开发文档的场景，例如查找订单 API 的使用方法。
• 需要构建和调试 Shopify Admin GraphQL 查询的场景，例如获取产品列表或更新订单状态。
• 希望在开发工具中直接访问 Shopify 资源，避免切换多个窗口的场景。

通过将 MCP 服务器集成到开发工具中，开发者可以在不离开当前工作流的情况下完成文档查阅和 API 构建，显著提升开发效率。

注意事项

在使用 Shopify Dev MCP Server 时，需要注意以下几点：

• 该服务目前仅支持 Shopify Admin GraphQL API，不支持其他 API。
• 需要 Node.js 环境运行，建议使用 npx 命令直接运行，无需额外安装。
• Windows 用户可能需要特殊配置，以确保命令正确执行。
• 该服务不会访问 Shopify 店铺数据，仅提供文档搜索和模式内省功能。

开发者在使用过程中如遇到问题，可以参考常见问题部分或查阅相关资源。

总结

Shopify Dev MCP Server 是一个专为 Shopify 开发者设计的工具，通过 MCP 协议与开发工具集成，提供文档搜索和 GraphQL 模式访问功能，帮助开发者更高效地进行 Shopify 开发。其核心优势在于无需离开开发环境即可完成文档查阅和 API 构建，显著提升开发效率。