Wonderkraftz - Premium Gifting Studio

Name: Wonderkraftz - Premium Gifting Studio
Author: rachit1987

行业场景

by rachit1987

浏览并购买 Wonderkraftz 高端礼品，支持 AI 推荐、购物车管理与结账流程。

GitHub

什么是 Wonderkraftz - Premium Gifting Studio？

浏览并购买 Wonderkraftz 高端礼品，支持 AI 推荐、购物车管理与结账流程。

README

Wonderkraftz MCP Server

An MCP (Model Context Protocol) server that connects AI assistants to the Wonderkraftz Premium Gifting Studio. Browse products, get personalized gift recommendations, manage your cart, and checkout — all through natural language in your AI assistant.

Features

Product Search — Search the catalog by keyword, occasion, or gift type
Product Details — Get full product info including variants, pricing, and images
Collections — Browse curated gift collections (Corporate Gifts, Wedding Hampers, etc.)
Recommendations — Get product suggestions based on a product you like
Cart Management — Create carts, add/update/remove items
Checkout — Get a checkout URL to complete your purchase in a browser
Store Policies — View shipping, returns, and privacy policies

Quick Start

Option 1: npx (no install needed)

bash

SHOPIFY_STORE_DOMAIN=64cd5c-2.myshopify.com \
SHOPIFY_STOREFRONT_ACCESS_TOKEN=aeeec5ab77309d1c339d2971f56b6506 \
npx wonderkraftz-mcp

Option 2: Install globally

bash

npm install -g wonderkraftz-mcp

Setup

Cursor IDE

Add to your project's .cursor/mcp.json:

json

{
  "mcpServers": {
    "wonderkraftz": {
      "command": "npx",
      "args": ["-y", "wonderkraftz-mcp"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "64cd5c-2.myshopify.com",
        "SHOPIFY_STOREFRONT_ACCESS_TOKEN": "aeeec5ab77309d1c339d2971f56b6506"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

json

{
  "mcpServers": {
    "wonderkraftz": {
      "command": "npx",
      "args": ["-y", "wonderkraftz-mcp"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "64cd5c-2.myshopify.com",
        "SHOPIFY_STOREFRONT_ACCESS_TOKEN": "aeeec5ab77309d1c339d2971f56b6506"
      }
    }
  }
}

ChatGPT / Grok / Remote AI Tools

Use the hosted HTTP endpoint -- no install needed:

code

https://wonderkraftz-mcp.onrender.com/mcp

Point your MCP client to this URL. It supports Streamable HTTP transport.

Self-Hosted HTTP (optional)

To run the HTTP transport yourself:

bash

SHOPIFY_STORE_DOMAIN=64cd5c-2.myshopify.com \
SHOPIFY_STOREFRONT_ACCESS_TOKEN=aeeec5ab77309d1c339d2971f56b6506 \
npx wonderkraftz-mcp-http

The server starts on http://localhost:3000/mcp (or set PORT env var).

Transports

Transport	Entry Point	Use Case
stdio	`wonderkraftz-mcp`	Cursor, Claude Desktop, local AI tools
Streamable HTTP	`wonderkraftz-mcp-http`	ChatGPT, Grok, remote/cloud AI tools

Environment Variables

Variable	Description	Required
`SHOPIFY_STORE_DOMAIN`	Shopify store domain (e.g., `your-store.myshopify.com`)	Yes
`SHOPIFY_STOREFRONT_ACCESS_TOKEN`	Public Storefront API access token	Yes
`PORT`	HTTP server port (default: 3000, HTTP transport only)	No

Available Tools

Tool	Description
`search_products`	Search the product catalog by keyword
`get_product_details`	Get full details for a product by handle or ID
`get_collections`	List all product collections
`get_collection_products`	Browse products in a specific collection
`get_recommendations`	Get product recommendations based on a product
`create_cart`	Create a new shopping cart with items
`add_to_cart`	Add items to an existing cart
`update_cart`	Update item quantities in a cart
`remove_from_cart`	Remove items from a cart
`get_cart`	View cart contents and totals
`get_checkout_url`	Get checkout URL to complete purchase
`get_store_policies`	View store shipping, return, and privacy policies

Available Resources

URI	Description
`wonderkraftz://store/info`	Store information, branding, and payment settings
`wonderkraftz://collections`	List of all product collections

Example Conversations

"Show me corporate gift options under 2000 rupees"

"I need a wedding gift hamper. What do you recommend?"

"Add the luxury gift box to my cart and give me the checkout link"

"What's your return policy?"

Development

bash

git clone https://github.com/rachit1987/wonderkraftz-mcp.git
cd wonderkraftz-mcp
npm install
cp .env.example .env  # Add your Shopify credentials
npm run build
npm start             # stdio transport
npm run start:http    # HTTP transport

License

MIT

常见问题