Wonderkraftz Premium Gifting Studio

Wonderkraftz MCP 服务

一个 MCP（Model Context Protocol）服务，可将 AI 助手连接到 Wonderkraftz 高端礼品工作室。浏览商品、获取个性化礼品推荐、管理购物车并结账——全部通过 AI 助手中的自然语言完成。

功能

• 商品搜索 — 按关键词、场合或礼品类型搜索商品目录
• 商品详情 — 获取完整商品信息，包括款式、价格和图片
• 系列 — 浏览精选礼品系列（企业礼品、婚礼礼篮等）
• 推荐 — 根据您喜欢的商品获取商品推荐
• 购物车管理 — 创建购物车、添加／更新／移除商品
• 结账 — 获取结账 URL，以便在浏览器中完成购买
• 商店政策 — 查看配送、退货和隐私政策

快速开始

选项 1：npx（无需安装）

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

选项 2：全局安装

npm install -g wonderkraftz-mcp

设置

Cursor IDE

添加到项目的 .cursor/mcp.json：

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

Claude Desktop

添加到 claude_desktop_config.json：

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

ChatGPT / Grok / 远程 AI 工具

使用托管的 HTTP 端点——无需安装：

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

将 MCP 客户端指向此 URL。它支持 Streamable HTTP 传输。

自托管 HTTP（可选）

要自行运行 HTTP 传输：

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

服务会在 http://localhost:3000/mcp 启动（或设置 PORT 环境变量）。

传输方式

传输方式	入口点	使用场景
stdio	wonderkraftz-mcp	Cursor、Claude Desktop、本地 AI 工具
Streamable HTTP	wonderkraftz-mcp-http	ChatGPT、Grok、远程／云端 AI 工具

环境变量

变量	描述	必需
SHOPIFY_STORE_DOMAIN	Shopify 商店域名（例如：your-store.myshopify.com）	是
SHOPIFY_STOREFRONT_ACCESS_TOKEN	公开的 Storefront API 访问令牌	是
PORT	HTTP 服务端口（默认值：3000，仅用于 HTTP 传输）	否

可用工具

工具	描述
search_products	按关键词搜索商品目录
get_product_details	根据句柄或 ID 获取商品的完整详情
get_collections	列出所有商品系列
get_collection_products	浏览特定系列中的商品
get_recommendations	根据商品获取商品推荐
create_cart	创建包含商品的新购物车
add_to_cart	将商品添加到现有购物车
update_cart	更新购物车中的商品数量
remove_from_cart	从购物车中移除商品
get_cart	查看购物车内容和总计
get_checkout_url	获取完成购买所需的结账 URL
get_store_policies	查看商店的配送、退货和隐私政策

可用资源

URI	描述
wonderkraftz://store/info	商店信息、品牌和付款设置
wonderkraftz://collections	所有商品系列的列表

对话示例

“给我看看价格低于 2000 卢比的企业礼品选项”

“我需要一份婚礼礼篮。你有什么推荐？”

“把豪华礼品盒加入购物车，并给我结账链接”

“你们的退货政策是什么？”

开发

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

许可证

MIT