@ curless/ shopify- storefront (中文(简体) )
A 类 商店作为 MCP 连接器 人工智能助理(Claude、ChatGPT和 任何其他MCP主机). 买家浏览目录、选择选项、建造推车 并传递链接到 商家自己买的 - 钱和 命令留在商场里 成果构成 MCP 应用程序 纸牌.
一个服务器,由配置文件驱动:商家名,工具名,词
他们卖什么 店铺的接线都来自 config.json,那么一秒钟
商人是第二个文件,不是叉子.
npm install -g @curless/shopify-storefront
STOREFRONT_CONFIG=./config.json \
STOREFRONT_SHOPIFY_CLIENT_ID=… STOREFRONT_SHOPIFY_CLIENT_SECRET=… \
curless-shopify-storefront
部署于22号节点. 它听着 PORT (默认 8090) 并期望 TLS 结束
在它前面设置的反向代理 X-Forwarded-For。 。 。 .
工具
从配置中命名 naming.prefix 和名词——带有前缀 acme 编辑
默认名词 product数字 :
| 工具 | 它会做什么 |
|---|---|
list_acme_products | 目录作为名片;可选 query, (中文(简体) ), maxPrice, (中文(简体) ), limit。 。 。 . |
get_acme_product | 一种产品:期权,价格,这些组合在库存中. |
add_to_acme_cart 编号 : view_acme_cart 编号 : clear_acme_cart | 这个服务器保存的一辆车,作为记忆,每个对话。 在买方付款之前,任何物品都不能送到Shoppify. |
get_acme_checkout_link | 一个变体的Shofify推车 或整个推车。 创造无相. |
lookup_acme_order | 一个订单,鉴于它的订单号 财务报告和审定财务报表 放在邮件里. |
get_acme_store_policies | 店内出版的回放,航运,隐私和名词页. |
check_acme_checkout_status | 只限卡:其开出的出票是否已经支付. |
配置
config.json 拥有所有能识别商家的东西; 环境
只有秘密和机器设置.
{
"id": "acme",
"server": { "name": "acme-shop", "title": "Acme", "websiteUrl": "https://acme.example" },
"naming": { "prefix": "acme" },
"shopify": { "mode": "env", "shopDomain": "acme.myshopify.com" },
"urls": { "appUrl": "https://mcp.acme.example" },
"legal": {
"operatorContact": "[email protected]",
"merchantContact": "[email protected]",
"updated": "1 October 2026"
}
}
shopify.mode: "env"服务一个商店,通过应用程序安装一次 OAuth 流量 (/auth/install); 符号存储于shopify.tokenPath(默认)/app/data/<id>-token.json——保留一卷."oauth-install"是多店的表格,店铺是安装的 应用程序和连接器 URL 是/s/<shop>/mcp。 。 。 .urls.appUrl在 Shopify 注册的应用程序 URL ;urls.publicUrl,当 设置,是主机名购买者连接到的.legal.*填补/privacy, (中文(简体) ),/terms财务报告和审定财务报表/docs页面目录 审取所读. 失去的联系人不会辜负靴子,但会留下空隙.
| 环境 | |
|---|---|
STOREFRONT_CONFIG | 路径 config.json (所须. |
STOREFRONT_SHOPIFY_CLIENT_ID 编号 : _CLIENT_SECRET | Shopify app的证书;这个秘密也签下了OAuth的回调和webhooks. |
STOREFRONT_SHOPIFY_ADMIN_TOKEN | 可选:一个已存在的Admin API 令牌,跳过安装. |
PORT | 默认 8090。 。 。 . |
CATALOG_REFRESH_MS | 默认 300000 (5分钟). 一个失败的刷新继续服务最后的好目录. |
OPENAI_APPS_CHALLENGE_TOKENS | host=token,… ——ChatGPT Apps域名验证. |
终点
POST /mcp (和 /)是MCP的终点(可流HTTP,JSON响应).
与此同时: /healthz, (中文(简体) ), /docs, (中文(简体) ), /privacy, (中文(简体) ), /terms, (中文(简体) ), /icon.png, (中文(简体) ),
/logo.png, (中文(简体) ), /img (卡片的图像代理 shopify CDN),和
设置路径 /auth/install, (中文(简体) ), /auth/callback, (中文(简体) ), /webhooks/shopify。 。 。 .
它守护着什么
- 售出时不需要书写进入商店. 退出为 Shopify 链接;没有卡号或支付符到达此服务器.
- 排序查询 需要命令号和电子邮件一起回答 a 错误的电子邮件和缺少的订单, 并暂停在5个错失后查找 15分钟之内,一个顺序号、一个电子邮件或一个谈话(50) 给一个网络地址 给整个店铺一百块.
- 限制: 60个请求,每个地址一分钟,1个 MB 请求机构,范围 工具参数.
- 商人自己的文字 (说明、政策)失去控制 和隐形字符, 长度被封住, 并被围住,直到到达 助理人员.
许可证
麻省理工学院