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

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
产品类型: 类型
供应商: 供应商名称
状态: active
价格: $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. Fork 存储库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 将分支推送到远程仓库 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request