金大哥 - Shopify Python MCP Server MCP 详情

article

README

🚀 Shopify Python MCP 服务器

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

🚀 快速开始

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

✨ 主要特性

工具

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

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

构建与发布

准备分发包的步骤如下：

同步依赖并更新锁定文件：
```
uv sync
```
构建包：
```
uv build
```
发布到 PyPI：
```
uv publish
```

⚠️ 重要提示

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

Shopify Python MCP Server