Shopify

Shopify Python MCP Server

Es un servidor MCP que se integra con la API de Shopify. Al usar este servidor, puede obtener y manipular información de productos de Shopify desde Claude Desktop.

Funciones

Herramientas

Este servidor proporciona las siguientes herramientas:

1. list_products: Obtener la lista de productos

   • limit: Número de productos a obtener (máximo 250, valor predeterminado 50)

2. get_product: Obtener información detallada del producto

   • product_id: ID del producto (obligatorio)

3. create_product: Crear un nuevo producto

   • title: Nombre del producto (obligatorio)
   • body_html: Descripción del producto (formato HTML)
   • vendor: Nombre del proveedor
   • product_type: Tipo de producto
   • tags: Etiquetas (separadas por comas)
   • status: Estado (active/draft/archived)
   • variants: Variaciones
   • options: Opciones
   • images: Imágenes

4. update_product: Actualizar un producto

   • product_id: ID del producto (obligatorio)
   • title: Nombre del producto
   • body_html: Descripción del producto (formato HTML)
   • vendor: Nombre del proveedor
   • product_type: Tipo de producto
   • tags: Etiquetas (separadas por comas)
   • status: Estado (active/draft/archived)
   • variants: Variaciones
   • options: Opciones
   • images: Imágenes

5. delete_product: Eliminar un producto

   • product_id: ID del producto (obligatorio)

Configuración

Variables de entorno requeridas

Para usar este servidor, debe configurar las siguientes variables de entorno:

• SHOPIFY_SHOP_URL: URL de la tienda Shopify (ejemplo: mystore.myshopify.com)
• SHOPIFY_API_KEY: Clave de API de Shopify Admin API
• SHOPIFY_API_PASSWORD: Contraseña de API de Shopify Admin API (Secreto)
• SHOPIFY_API_VERSION: Versión de la API de Shopify (predeterminado: 2023-10)

Configuración en Claude Desktop

Para usarlo en Claude Desktop, agregue la siguiente configuración a claude_desktop_config.json:

macOS

Ubicación del archivo de configuración: ~/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"
    }
  }
}

Uso

Para usar este servidor en Claude Desktop, llame a las herramientas de la siguiente manera:

Obtener la lista de productos

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

Obtener información detallada del producto

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

Crear un nuevo producto

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

Actualizar un producto

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

Eliminar un producto

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

Desarrollo

Instalación de dependencias

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

Depuración

Puede depurar usando MCP Inspector:

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

Compilación y publicación

Para preparar el paquete para distribución:

1. Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

2. Compilar el paquete:

uv build

3. Publicar en PyPI:

uv publish

Nota: Debe configurar las credenciales de PyPI mediante variables de entorno o indicadores de línea de comandos:

• Token: --token o UV_PUBLISH_TOKEN
• O nombre de usuario/contraseña: --username/UV_PUBLISH_USERNAME y --password/UV_PUBLISH_PASSWORD