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密钥
• SHOPIFY_API_PASSWORD: Shopify Admin API密码（Secret）
• SHOPIFY_API_VERSION: Shopify API版本（默认: 2023-10）

在Claude Desktop中的配置

如果您要在Claude Desktop中使用，请在claude_desktop_config.json文件中添加以下配置：

macOS

配置文件位置: ~/Library/Application Support/Claude/claude_desktop_config.json

"mcpServers": {
  "shopify-py-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/your_path/shopify-py-mcp",
      "run",
      "shopify-py-mcp"
    ],
    "env": {
      "SHOPIFY_SHOP_URL": "your-store.myshopify.com",
      "SHOPIFY_API_KEY": "your-api-key",
      "SHOPIFY_API_PASSWORD": "your-api-password",
      "SHOPIFY_API_VERSION": "2023-10"
    }
  }
}

使用方法

要在Claude Desktop中使用此服务器，请按如下方式调用工具：

获取商品列表

商品一覧を取得してください。

获取商品详情

商品ID 1234567890の詳細情報を取得してください。

创建新商品

以下の情報で新しい商品を作成してください：
- 商品名: サンプル商品
- 説明: これはサンプル商品です。
- 価格: 1000円

更新商品

商品ID 1234567890を以下の情報で更新してください：
- 商品名: 更新後の商品名
- 価格: 2000円

删除商品

商品ID 1234567890を削除してください。

开发

安装依赖

cd shopify-py-mcp
uv sync --dev --all-extras

调试

可以使用MCP Inspector进行调试：

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

构建与发布

准备用于分发的包：

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

uv sync

1. 构建包：

uv build

1. 发布到PyPI：

uv publish

注意: 您需要通过环境变量或命令标志来设置PyPI认证信息：

• 令牌: --token 或 UV_PUBLISH_TOKEN
• 或用户名/密码: --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD