Shopify商品管理服务器

一个与Shopify API集成的Python服务器,用于从Claude Desktop获取和操作Shopify商品信息。

  • by kishimoto-banana
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 kishimoto-banana/shopify-py-mcp

使用说明

Shopify Python MCP服务器

Shopify API联合MCP服务器。通过使用此服务器Claude Desktop从…开始Shopify的商品信息。

机能

工具

此服务器提供以下工具:

  1. 产品列表:获取商品一览表

    • limit:获得的商品数(最多250个,默认值为50个)
  2. get_产品:获取商品的详细信息

    • product_id:商品ID(必须)
  3. 创建产品:创建新商品

    • 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. 删除产品:删除商品

    • 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密码
  • 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