Servidor MCP de Shopify

Un servidor de Protocolo de Contexto de Modelo (MCP) para conectar a clientes como Claude con los datos de la tienda Shopify. Este servidor expone herramientas para recuperar información de productos y clientes de tu tienda Shopify.

Herramientas

• get-product-list : recupera una lista de productos de tu tienda Shopify

• get-customer-list : recupera una lista de clientes de tu tienda Shopify

• Próximamente habrá más

Related MCP server: WooCommerce MCP Server

Prerrequisitos

• Python 3.12 o superior

• Una tienda Shopify con acceso API

• Credenciales de la API de Shopify (clave API, contraseña y token de acceso)

Instalación

1. Clonar el repositorio:

git clone https://github.com/siddhantbajaj/shopify-mcp-server.git
cd shopify-mcp-server

2. Crear y activar un entorno virtual usando uv :

uv venv
source .venv/bin/activate  # On Unix/MacOS
# or
.venv\Scripts\activate  # On Windows

3. Instalar el paquete:

uv pip install -e .

Configuración

1. Crea un archivo .env en el directorio raíz con tus credenciales de Shopify:

SHOPIFY_SHOP_URL="your-store.myshopify.com"
SHOPIFY_API_KEY="your_api_key"
SHOPIFY_PASSWORD="your_api_password"
SHOPIFY_ACCESS_TOKEN="your_access_token"

Reemplace los valores de marcador de posición con sus credenciales de API de Shopify reales.

Uso

1. Inicie el servidor MCP:

python -m shopify_mcp_server.server

2. El servidor expone dos herramientas:

obtener-lista-de-productos

Recupera una lista de productos de tu tienda Shopify.

• Parámetro opcional: limit (predeterminado: 10): número máximo de productos a devolver

obtener lista de clientes

Recupera una lista de clientes de tu tienda Shopify.

• Parámetro opcional: limit (predeterminado: 10): número máximo de clientes a devolver

Formato de respuesta de la herramienta

Productos

Products (showing X):

Title: Product Name
ID: 123456789
Product Type: Type
Vendor: Vendor Name
Status: active
Price: $XX.XX
---

Clientes

Customers (showing X):

Name: John Doe
ID: 123456789
Email: john@example.com
Orders Count: X
Total Spent: $XX.XX
---

Desarrollo

Este proyecto utiliza:

• MCP (Protocolo de Contexto de Modelo) para crear herramientas impulsadas por IA

• API de Python de Shopify para la integración de Shopify

• UV para la gestión de la dependencia

Seguridad

• Nunca envíe su archivo .env al control de versiones

• Mantenga seguras sus credenciales de API de Shopify

• Utilice variables de entorno para información confidencial

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Contribuyendo

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción