Siddhantbajaj Shopify MCP Server

🚀 Shopify MCP 服务器

Shopify MCP 服务器是一个模型上下文协议（MCP）服务器，它能将客户端（如Claude）与您的Shopify商店数据连接起来。此服务器提供了一系列工具，可用于从您的Shopify商店获取产品和客户信息，为您的业务数据管理提供便利。

🚀 快速开始

先决条件

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

安装

1. 克隆仓库：

git clone https://github.com/siddhantbajaj/shopify-mcp-server.git
cd shopify-mcp-server

2. 创建并激活虚拟环境使用uv：

uv venv
source .venv/bin/activate  # 在Unix/MacOS上
# 或者
.venv\Scripts\activate  # 在Windows上

3. 安装包：

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

2. 该服务器公开了两个工具：

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文件。

🤝 贡献

1. 分叉仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m '添加一些很棒的功能'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开Pull Request