Shopify Python MCP Server

🚀 Shopify Python MCP 服务器

这是一个与 Shopify API 连接的 MCP 服务器。借助该服务器，你能够从 Claude Desktop 获取并操作 Shopify 的商品信息。

🚀 快速开始

若要使用此服务器，你需要完成环境变量的设置。在使用 Claude Desktop 时，还需进行相应配置。具体设置步骤如下文所述。

✨ 主要特性

工具

该服务器提供了一系列实用工具，可用于对 Shopify 商品信息进行操作，具体如下：

1. list_products：用于获取商品列表。
   • limit：指定要获取的商品数量，最大值为 250，默认值为 50。
2. get_product：用于获取商品的详细信息。
   • product_id：商品的唯一标识，此为必填项。
3. create_product：用于创建新的商品。
   • title：商品的名称，必填。
   • body_html：商品的描述，采用 HTML 格式。
   • vendor：商品的供应商名称。
   • product_type：商品的类型。
   • tags：商品的标签，以逗号分隔。
   • status：商品的状态，可选择的值为 active（活跃）、draft（草稿）、archived（存档）。
   • variants：商品的变体。
   • options：商品的选项。
   • images：商品的图片。
4. update_product：用于更新商品的信息。
   • product_id：商品的唯一标识，必填。
   • title：商品的名称。
   • body_html：商品的描述，采用 HTML 格式。
   • vendor：商品的供应商名称。
   • product_type：商品的类型。
   • tags：商品的标签，以逗号分隔。
   • status：商品的状态，可选择的值为 active（活跃）、draft（草稿）、archived（存档）。
   • variants：商品的变体。
   • options：商品的选项。
   • images：商品的图片。
5. delete_product：用于删除指定的商品。
   • product_id：商品的唯一标识，必填。

📦 安装指南

必要的环境变量

使用该服务器前，你需要设置以下环境变量：

• SHOPIFY_SHOP_URL：Shopify 商店的 URL，例如: mystore.myshopify.com。
• SHOPIFY_API_KEY：Shopify Admin API 的 API 密钥。
• SHOPIFY_API_PASSWORD：Shopify Admin API 的 API 密码（Secret）。
• SHOPIFY_API_VERSION：Shopify API 的版本，默认值为 2023 - 10。

Claude Desktop 设置

在 Claude Desktop 中使用该服务器时，需要进行如下配置：

{
  "env": {
    "SHOPIFY_SHOP_URL": "myshop.myshopify.com",
    "SHOPIFY_API_KEY": "your_api_key",
    "SHOPIFY_API_PASSWORD": "your_api_password"
  }
}

💻 使用示例

基础用法

获取商品列表

list_products --limit=10

删除指定 ID 的商品

delete_product --product_id=abc123

🔧 技术细节

开发

安装依赖

使用以下命令同步并安装依赖项：

uv sync

调试

使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector uv --directory /your_path/shopify-py run shopify-py

构建与发布

准备分发包的步骤如下：

1. 同步依赖并更新锁定文件：

   uv sync
   

2. 构建包：

   uv build
   

3. 发布到 PyPI：

   uv publish
   

⚠️ 重要提示

发布到 PyPI 需要设置认证信息，你可以通过环境变量或命令行参数指定。