Shopify MCP Server

Shopify MCP Server

site icon
2025.01.29 2
PythonShopify 集成数据访问开发效率
Shopify MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,用于连接客户端(如 Claude)与 Shopify 商店数据。该服务提供了从 Shopify 商店检索产品和客户信息的工具。
View on GitHub

Overview

基本能力

产品定位

Shopify MCP Server 是一个用于连接 Shopify 商店数据的中间件服务,旨在通过 MCP 协议为客户端提供 Shopify 数据访问能力。

核心功能

  • 提供 get-product-list 工具,用于从 Shopify 商店检索产品列表
  • 提供 get-customer-list 工具,用于从 Shopify 商店检索客户列表
  • 支持通过环境变量配置 Shopify API 凭证
  • 基于 MCP 协议构建,可与支持 MCP 的客户端集成

适用场景

  • 开发者需要将 Shopify 数据集成到支持 MCP 的 AI 应用中
  • 需要自动化获取 Shopify 产品和客户信息的场景
  • 构建基于 Shopify 数据的 AI 助手或分析工具

工具列表

  1. get-product-list:从 Shopify 商店检索产品列表,支持 limit 参数控制返回数量
  2. get-customer-list:从 Shopify 商店检索客户列表,支持 limit 参数控制返回数量

常见问题解答

  • 安全问题:建议不要将 .env 文件提交到版本控制,妥善保管 Shopify API 凭证
  • 开发依赖:使用 UV 进行依赖管理,确保 Python 3.12 或更高版本

使用教程

使用依赖

  • Python 3.12 或更高版本
  • Shopify 商店 API 访问权限
  • Shopify API 凭证(API Key、Password 和 Access Token)

安装教程

  1. 克隆仓库:
git clone https://github.com/siddhantbajaj/shopify-mcp-server.git
cd shopify-mcp-server
  1. 创建并激活虚拟环境:
uv venv
source .venv/bin/activate  # Unix/MacOS
# 或
.venv\Scripts\activate  # Windows
  1. 安装包:
uv pip install -e .
  1. 配置 .env 文件:
SHOPIFY_SHOP_URL="your-store.myshopify.com"
SHOPIFY_API_KEY="your_api_key"
SHOPIFY_PASSWORD="your_api_password"
SHOPIFY_ACCESS_TOKEN="your_access_token"

调试方式

  1. 启动 MCP 服务器:
python -m shopify_mcp_server.server
  1. 测试工具:
  2. 使用 get-product-list 检索产品
  3. 使用 get-customer-list 检索客户

工具响应格式示例:

Products (showing X):

Title: Product Name
ID: 123456789
Product Type: Type
Vendor: Vendor Name
Status: active
Price: $XX.XX
---

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。