Shopify数据连接服务

一个用于连接Claude等客户端与Shopify商店数据的模型上下文协议(MCP)服务器,提供获取产品和客户信息的工具。

  • by siddhantbajaj
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 siddhantbajaj/shopify-mcp-server

使用说明

Shopify MCP服务器

一个模型上下文协议(MCP)服务器,用于将Claude等客户端与Shopify商店数据连接起来。此服务器公开了从Shopify商店检索产品和客户信息的工具。

工具

  • get-product-list:从您的Shopify商店检索产品列表
  • get-customer-list:从您的Shopify商店检索客户列表
  • 更多即将推出

先决条件

  • Python 3.12或更高版本
  • 可访问API的Shopify商店
  • Shopify API凭证(API密钥、密码和访问令牌)

安装

  1. 克隆存储库:
git clone https://github.com/siddhantbajaj/shopify-mcp-server.git
cd shopify-mcp-server
  1. 使用创建和激活虚拟环境 uv:
uv venv
source .venv/bin/activate  # On Unix/MacOS
# or
.venv\Scripts\activate  # On Windows
  1. 安装软件包:
uv pip install -e .

配置

  1. 创建一个 .env 使用您的Shopify凭据在根目录中创建文件:
SHOPIFY_SHOP_URL="your-store.myshopify.com"
SHOPIFY_API_KEY="your_api_key"
SHOPIFY_PASSWORD="your_api_password"
SHOPIFY_ACCESS_TOKEN="your_access_token"

将占位符值替换为您的实际Shopify API凭据。

用法

  1. 启动MCP服务器:
python -m shopify_mcp_server.server
  1. 服务器公开了两个工具:

获取产品列表

从您的Shopify商店检索产品列表。

  • 可选参数: limit (默认值:10)-要退回的最大产品数

获取客户列表

从您的Shopify商店检索客户列表。

  • 可选参数: limit (默认值:10)-要返回的最大客户数

工具响应格式

产品

Products (showing X):

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

客户

Customers (showing X):

Name: John Doe
ID: 123456789
Email: john@example.com
Orders Count: X
Total Spent: $XX.XX
---

发展

本项目使用:

安全

  • 永远不要承诺你的 .env 文件到版本控制
  • 确保您的Shopify API证书安全
  • 对敏感信息使用环境变量

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。

贡献

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求