Shopify Python MCP 服务器

这是一个与 Shopify API 交互的 MCP 服务器。通过使用此服务器，您可以从 Claude Desktop 获取和操作 Shopify 的商品信息。

<a href="https://glama.ai/mcp/servers/zfff0mhppb"> <img width="380" height="200" src="https://glama.ai/mcp/servers/zfff0mhppb/badge" alt="Shopify Python Server MCP server" /> </a>

功能

工具

此服务器提供以下工具：

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 中使用，请将以下配置添加到 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

2. 构建软件包：

uv build

3. 发布到 PyPI：

uv publish

注意：您需要通过环境变量或命令行标志设置 PyPI 凭据：

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