Shopify MCP Server

这是一个模型上下文协议（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

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）- 返回的客户最大数量

工具响应格式

产品

产品（显示 X 条）：

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

客户

客户（显示 X 条）：

姓名: John Doe
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. 打开拉取请求