article
README
🚀 Shopify MCP 服务器
Shopify MCP 服务器是一个模型上下文协议(MCP)服务器,它能将客户端(如Claude)与您的Shopify商店数据连接起来。此服务器提供了一系列工具,可用于从您的Shopify商店获取产品和客户信息,为您的业务数据管理提供便利。
🚀 快速开始
先决条件
- Python 3.12 或更高版本
- 具有API访问权限的Shopify商店
- Shopify API凭证(API密钥、密码和访问令牌)
安装
- 克隆仓库:
git clone https://github.com/siddhantbajaj/shopify-mcp-server.git
cd shopify-mcp-server
- 创建并激活虚拟环境使用
uv:
uv venv
source .venv/bin/activate # 在Unix/MacOS上
# 或者
.venv\Scripts\activate # 在Windows上
- 安装包:
uv pip install -e .
配置
- 在根目录中创建一个
.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凭证。
使用方法
- 启动MCP服务器:
python -m shopify_mcp_server.server
- 该服务器公开了两个工具:
get-product-list
从您的Shopify商店中检索产品列表。
- 可选参数:
limit(默认值为10)- 返回的产品最大数量
get-customer-list
从您的Shopify商店中检索客户列表。
- 可选参数:
limit(默认值为10)- 返回的客户最大数量
✨ 主要特性
get-product-list:从您的Shopify商店中检索产品列表get-customer-list:从您的Shopify商店中检索客户列表- 更多功能即将到来
💻 使用示例
工具响应格式
产品
商品 (显示 X):
标题: 商品名称
ID: 123456789
类型: 类型
供应商: 供应商名称
状态: active
价格: $XX.XX
---
客户
客户 (显示 X):
姓名: 约翰·多伊
ID: 123456789
电子邮件: john@example.com
订单数: X
总消费金额: $XX.XX
---
🔧 技术细节
该项目使用:
- MCP(模型上下文协议) 用于构建AI驱动的工具
- Shopify Python API 用于Shopify集成
- UV 用于依赖管理
⚠️ 安全提示
⚠️ 重要提示
- 永远不要将
.env文件提交到版本控制中- 保持您的Shopify API凭证安全
- 使用环境变量来存储敏感信息
📄 许可证
该项目在MIT许可证下发布 - 有关详细信息,请参阅LICENSE文件。
🤝 贡献
- 分叉仓库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交更改(
git commit -m '添加一些很棒的功能') - 推送到分支(
git push origin feature/amazing-feature) - 打开Pull Request
微信扫一扫