@pranavchavda/shopify-feature-box-mcp NPM

Shopify Feature Box MCP Server

An MCP (Model Context Protocol) server that allows AI agents to automatically create compelling feature boxes for Shopify products with images and descriptions.

Installation

npx @your-username/shopify-feature-box-mcp

Or install globally:

npm install -g @your-username/shopify-feature-box-mcp

Setup

Set these environment variables:

export SHOPIFY_ACCESS_TOKEN="your_shopify_admin_api_token"
export SHOPIFY_SHOP_URL="https://your-shop.myshopify.com"

Usage with AI Agents

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "shopify-feature-box": {
      "command": "npx",
      "args": ["@your-username/shopify-feature-box-mcp"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "your_token_here",
        "SHOPIFY_SHOP_URL": "https://your-shop.myshopify.com"
      }
    }
  }
}

Direct Usage

echo '{"method": "search_products", "params": {"query": "coffee"}, "id": "1"}' | npx @your-username/shopify-feature-box-mcp

Available Methods

`search_products`

Find products in your Shopify store:

{
  "method": "search_products",
  "params": {"query": "laptop"},
  "id": "1"
}

`get_product`

Get detailed product information:

{
  "method": "get_product", 
  "params": {"productId": "123456789"},
  "id": "2"
}

`create_feature_box`

Create a new feature box:

{
  "method": "create_feature_box",
  "params": {
    "title": "Advanced Camera System",
    "text": "Professional-quality photos with triple-lens system",
    "productId": "123456789",
    "imageUrl": "https://images.unsplash.com/photo-123456789",
    "handle": "advanced-camera-1"
  },
  "id": "3"
}

`list_feature_boxes`

List all feature boxes for a product:

{
  "method": "list_feature_boxes",
  "params": {"productId": "123456789"},
  "id": "4"
}

Integration Example

const { spawn } = require('child_process');

const mcp = spawn('npx', ['@your-username/shopify-feature-box-mcp'], {
  stdio: ['pipe', 'pipe', 'inherit'],
  env: {
    ...process.env,
    SHOPIFY_ACCESS_TOKEN: 'your_token',
    SHOPIFY_SHOP_URL: 'https://your-shop.myshopify.com'
  }
});

// Send request
const request = {
  method: 'create_feature_box',
  params: {
    title: 'Smart Features',
    text: 'AI-powered functionality',
    productId: '123456789',
    imageUrl: 'https://example.com/image.jpg'
  },
  id: '1'
};

mcp.stdin.write(JSON.stringify(request) + '\n');

mcp.stdout.on('data', (data) => {
  const response = JSON.parse(data.toString());
  console.log('Feature box created:', response.result);
});