Wonderkraftz - Premium Gifting Studio

io.github.rachit1987由 GitHub 账号 rachit1987 发布v1.0.0更新于 Oct 24, 2026

Browse and shop Wonderkraftz premium gifts. Recommendations, cart, and checkout via AI.

已验证STDIO仅桌面效率与工作流商业与电商

概览

AI 生成的概览

让助手浏览 Wonderkraftz 礼品目录、获取推荐、管理购物车，并生成结账链接。

可以做什么
将助手连接到 Wonderkraftz Premium Gifting Studio 店铺。工具涵盖商品搜索、商品详情、系列、推荐、创建与更新购物车、查看购物车、生成结账链接以及店铺政策。另有两个资源提供店铺信息和系列列表。
适用场景
适合以对话方式选购高端或企业礼品：按场合或关键词查找商品、比较选项、组建购物车，并获取在浏览器中完成购买的链接。
运行要求
通过 npx 或全局 npm 安装作为本地进程运行，需要 Node.js。需要环境变量 SHOPIFY_STORE_DOMAIN 和 SHOPIFY_STOREFRONT_ACCESS_TOKEN。文档还提到供远程客户端使用的托管 HTTP 端点。仅支持桌面端。
安装前请注意
README 的配置示例以明文展示了店铺域名和 SHOPIFY_STOREFRONT_ACCESS_TOKEN 的值，应视为已泄露，请使用自己的凭据而非照抄。购物车工具会写入购物车，结账会跳转到浏览器完成真实购买。托管 HTTP 端点会把请求发送到第三方服务器。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Wonderkraftz - Premium Gifting Studio，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[Wonderkraftz Logo]

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:

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

TransportEntry PointUse Case
stdiowonderkraftz-mcpCursor, Claude Desktop, local AI tools
Streamable HTTPwonderkraftz-mcp-httpChatGPT, Grok, remote/cloud AI tools

Environment Variables

VariableDescriptionRequired
SHOPIFY_STORE_DOMAINShopify store domain (e.g., your-store.myshopify.com)Yes
SHOPIFY_STOREFRONT_ACCESS_TOKENPublic Storefront API access tokenYes
PORTHTTP server port (default: 3000, HTTP transport only)No

Available Tools

ToolDescription
search_productsSearch the product catalog by keyword
get_product_detailsGet full details for a product by handle or ID
get_collectionsList all product collections
get_collection_productsBrowse products in a specific collection
get_recommendationsGet product recommendations based on a product
create_cartCreate a new shopping cart with items
add_to_cartAdd items to an existing cart
update_cartUpdate item quantities in a cart
remove_from_cartRemove items from a cart
get_cartView cart contents and totals
get_checkout_urlGet checkout URL to complete purchase
get_store_policiesView store shipping, return, and privacy policies

Available Resources

URIDescription
wonderkraftz://store/infoStore information, branding, and payment settings
wonderkraftz://collectionsList 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.gitcd wonderkraftz-mcpnpm installcp .env.example .env  # Add your Shopify credentialsnpm run buildnpm start             # stdio transportnpm run start:http    # HTTP transport

License

MIT

来源：README.md，提交 4854687

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。