Home
Login
Shopify/dev-mcpPlease refer to the latest official releases for information GitHub Homepage

Shopify.dev MCP 伺服器 - 透過模型上下文協定與 Shopify 開發平台互動的工具

ISCTypeScript 371Shopifydev-mcp Last Updated: 2025-06-20

Shopify.dev MCP 伺服器

項目概述

Shopify.dev MCP 伺服器是一個實現了模型上下文協定（Model Context Protocol, MCP）的伺服器，專門用於與 Shopify 開發平台進行互動。該項目為開發者提供了一套強大的工具來存取和操作各種 Shopify API。

核心功能

支援的工具

工具名稱 描述
search_dev_docs 搜尋 shopify.dev 官方文檔
introspect_admin_schema 訪問和搜尋 Shopify Admin GraphQL 模式

內建提示範本

提示名稱 描述
shopify_admin_graphql 幫助編寫 Shopify Admin API 的 GraphQL 操作

安裝和使用

快速啟動

使用 npx 命令可以快速運行 Shopify MCP 伺服器：

npx -y @shopify/dev-mcp@latest

配置方法

通用配置

添加以下配置到你的 MCP 客戶端中。更多資訊請參考 Cursor MCP 文檔 或 Claude Desktop MCP 指南：

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

Windows 系統配置

在 Windows 系統上，你可能需要使用以下替代配置：

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

開發環境搭建

安裝依賴

npm install

開發流程

  1. 修改源文件 - 對項目原始碼進行修改
  2. 編譯項目 - 運行以下命令進行編譯：
    npm run build
  3. 運行測試 - 執行測試用例：
    npm run test
  4. 本地運行 - 添加一個 MCP 伺服器配置，運行以下命令：
    node <項目絕對路徑>/dist/index.js

技術架構

核心技術

  • MCP SDK: 項目基於模型上下文協定 SDK 構建
  • Node.js: 使用 Node.js 作為運行環境
  • TypeScript: 使用 TypeScript 進行開發（推測）
  • GraphQL: 支援 Shopify Admin GraphQL API 操作

通訊協定

伺服器通過模型上下文協定與 Shopify 開發平台進行通訊，提供了標準化的介面來訪問 Shopify 的各種開發資源。

使用場景

開發者工具集成

  • IDE 集成: 可以集成到支援 MCP 的開發環境中，如 Cursor
  • AI 助手: 可以與 Claude Desktop 等 AI 工具配合使用
  • 文檔查詢: 快速搜尋和訪問 Shopify 官方文檔
  • API 開發: 輔助進行 GraphQL API 的開發和調試

典型工作流

  1. 文檔搜尋: 使用 search_dev_docs 工具快速找到相關的開發文檔
  2. 模式探索: 通過 introspect_admin_schema 工具了解可用的 GraphQL 字段和操作
  3. 代碼生成: 利用 shopify_admin_graphql 提示範本生成符合規範的 GraphQL 查詢
  4. API 調試: 在開發過程中快速驗證 API 調用

項目特點

優勢

  • 官方支援: 由 Shopify 官方維護，確保與平台的兼容性和及時更新
  • 標準協定: 基於 MCP 標準，具有良好的互操作性
  • 開箱即用: 通過 npx 可以直接使用，無需複雜的安裝過程
  • 開發友好: 提供了完整的開發和測試工具鏈

適用人群

  • Shopify 應用開發者
  • 主題開發者
  • 使用 Shopify API 的第三方開發者
  • 需要頻繁查詢 Shopify 文檔的開發者

相關資源

總結

Shopify.dev MCP 伺服器是一個強大的開發工具，它通過標準化的協定為開發者提供了便捷的方式來訪問 Shopify 的開發資源。無論你是在構建 Shopify 應用、開發主題，還是集成第三方服務，這個工具都能顯著提高你的開發效率。

Star History Chart