Shopify Python MCP 服务器

这是一个与Shopify API连接的MCP服务器。使用该服务器可以从Claude Desktop获取并操作Shopify的商品信息。

功能

工具

该服务器提供以下工具：

1. list_products: 获取商品列表

   • limit: 要获取的商品数量（最大250，默认值为50）

2. get_product: 获取商品的详细信息

   • product_id: 商品ID（必填）

3. create_product: 创建新商品

   • title: 商品名称（必填）
   • body_html: 商品描述（HTML格式）
   • vendor: 供应商名称
   • product_type: 商品类型
   • tags: 标签（逗号分隔）
   • status: 状态（active/draft/archived）
   • variants: 变体
   • options: 选项
   • images: 图片

4. update_product: 更新商品信息

   • product_id: 商品ID（必填）
   • title: 商品名称
   • body_html: 商品描述（HTML格式）
   • vendor: 供应商名称
   • product_type: 商品类型
   • tags: 标签（逗号分隔）
   • status: 状态（active/draft/archived）
   • variants: 变体
   • options: 选项
   • images: 图片

5. delete_product: 删除商品

   • product_id: 商品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需要设置认证信息，可以通过环境变量或命令行参数指定。