Shopify MCP 服务器

一个模型上下文协议（MCP）服务器，用于将像Claude这样的客户端与Shopify商店数据连接起来。该服务器提供了从您的Shopify商店检索产品和客户信息的工具。

工具

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

先决条件

• Python 3.12 或更高版本
• 拥有API访问权限的Shopify商店
• Shopify API凭证（API密钥、密码和访问令牌）

安装

1. 克隆仓库：
   bash
   git clone https://github.com/siddhantbajaj/shopify-mcp-server.git
   cd shopify-mcp-server

2. 使用uv创建并激活虚拟环境：
   bash
   uv venv
   source .venv/bin/activate # 在Unix/MacOS上

   或者

   .venvScriptsactivate # 在Windows上

3. 安装包：
   bash
   uv pip install -e .

配置

1. 在根目录下创建一个.env文件，并填入您的Shopify凭证：
   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"

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

使用

1. 启动MCP服务器：
   bash
   python -m shopify_mcp_server.server

2. 服务器提供两个工具：

get-product-list

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

• 可选参数：limit（默认值：10）- 返回的最大产品数量

get-customer-list

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

• 可选参数：limit（默认值：10）- 返回的最大客户数量

工具响应格式

产品

产品（显示X条）：

标题: 产品名称
ID: 123456789
产品类型: 类型
供应商: 供应商名称
状态: active
价格: $XX.XX

客户

客户（显示X条）：

姓名: John Doe
ID: 123456789
电子邮件: john@example.com
订单数: X
总消费: $XX.XX

开发

该项目使用了以下技术：

• MCP (Model Context Protocol) 用于构建AI驱动的工具
• Shopify Python API 用于Shopify集成
• UV 用于依赖管理

安全性

• 切勿将您的.env文件提交到版本控制系统
• 确保您的Shopify API凭证安全
• 对于敏感信息，请使用环境变量

许可证

本项目根据MIT许可证发布 - 详情请参阅LICENSE文件。

贡献

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