Stienhardt

Stienhardt 在 MCP 上的商店

Stienhardt 是一家位于纽约的培育钻石珠宝商。本仓库记录并注册了我们的 Shopify UCP MCP 端点，并包含一个可运行示例，用于搜索库存并移交未付款的结账流程。Shopify 提供商务端点。我们另行提供的 Cloudflare Worker 会为库存查询注入个人资料，并提供八个教育类工具。披露：我们销售戒指。

无需账户即可试用

需要 Python 3 和网络连接。无需 API 密钥或第三方 Python 软件包。

git clone https://github.com/JacobiusMakes/stienhardt-store.git
cd stienhardt-store
python try_store.py

默认命令只搜索库存。它会输出产品标题、ID 和链接，不包含价格。在 Windows 上，如果 py 是你的 Python 启动器，请使用 py。

搜索会读取 Shopify 当前的商品目录。这并非独立的供应商库存检查：有些裸石记录是购物车载体，其目标页面可能会显示该钻石已售出，即使商品目录记录仍显示可用。将搜索结果视为可购买商品前，请先查看产品页面。未付款结账测试演示的是 API 移交流程，不会预留库存。

示例打印的产品链接会附带 utm_source=github、utm_medium=referral、utm_campaign=mcp-store 和 utm_content=runnable-example，以便统计来自本仓库的访问。现有查询参数、变体 ID 和归因标签都会保留。该命令本身不会发送分析事件；必须有人打开产品链接并访问商店。

如需复现结账移交流程：

python try_store.py --checkout

这会为第一个返回的变体创建一个匿名、未付款的购物车，并单独创建一个结账；随后会打印结账状态和链接主机名，再分别调用取消操作。这不会提供买家联系信息或支付工具，也绝不会调用 complete_checkout。它会在商店中创建真实的测试对象，因此请只运行一次，不要循环运行。创建请求发出后若发生网络故障，可能无法完成清理；对于结果不确定的创建请求，请勿自动重试。

已于 2026-09-08 验证：原始搜索返回了十个产品；购物车创建返回了 continue_url；结账创建返回状态 incomplete 和一个 continue_url，其主机名为 stienhard-stones.myshopify.com。购物车取消操作返回时没有工具错误，结账取消操作返回了 canceled。未尝试付款。请参阅 DEMO.md。

对于未完成的结账响应，Shopify 会设置 MCP isError: true，同时返回真实的结账 ID，以及关于缺少联系和配送信息的可恢复提示信息。该示例会识别这种移交响应，并保留 ID 以便取消。不要仅仅因为 isError 为 true 就丢弃该对象。

两个端点，功能各异

端点	提供的功能	个人资料处理方式
https://diamond-mcp.stienhardt.workers.dev/mcp	八个教育类工具、search_inventory、get_product。不提供购物车或结账工具。	由辅助服务注入
https://stienhard-stones.myshopify.com/api/ucp/mcp	13 个 Shopify 工具，涵盖商品目录、购物车、结账和订单	调用方在每次工具调用中提供 UCP 个人资料

对于支持远程 HTTP MCP 的客户端，请连接到辅助服务 URL（无需身份验证），并让它查找一颗 2 克拉的 Dutch Marquise。客户端账户、连接器可用性和设置各不相同。无需账户的使用方式包括上述 Python 示例和下方的 curl 代码块。辅助服务无法启动结账。

在终端中试用

托管辅助服务接受普通 POST 请求（JSON-RPC 2.0，Content-Type: application/json，无需会话、 无需身份验证、无需配置文件）。先列出工具，再搜索实时库存：

curl -s -X POST https://diamond-mcp.stienhardt.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -s -X POST https://diamond-mcp.stienhardt.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_inventory","arguments":{"query":"Dutch Marquise 2 carat","limit":3}}}'

原始端点允许匿名调用 initialize 和 tools/list，但每次 tools/call 都必须在 arguments.meta 中提供 UCP Agent 配置文件。ucp-agent 是一个连字符连接的键，而 meta 与工具自身的对象 （catalog、cart、checkout）是同级的，并非包裹这些对象的外层结构：

curl -s -X POST https://stienhard-stones.myshopify.com/api/ucp/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_catalog","arguments":{"meta":{"ucp-agent":{"profile":"https://cdn.jsdelivr.net/gh/JacobiusMakes/diamond-mcp@main/agent-profile.json"}},"catalog":{"query":"Dutch Marquise 2 carat"}}}}'

测试时使用 @main 即可；生产环境最好固定到某个提交。示例脚本固定使用 diamond-mcp@3955f7d88fe04cf5afa07f70065902eee684d443（截至 2026-09-08 的 HEAD，已验证可提供 application/json）。可能遇到以下两种错误，均为 HTTP 422，JSON-RPC 错误码为 -32001，提示 “UCP discovery failed”（端点并未宕机）：缺少 meta 时出现 invalid_profile_url（“Missing profile uri”）； 配置文件 URL 提供的内容类型有误时出现 profile_malformed（“Invalid content type”）（GitHub raw 提供 text/plain，因此失败；jsDelivr 提供 application/json）。

创建购物车时使用 arguments.cart，创建结账时使用 arguments.checkout；两者都接受包含变体 ID 和数量的 line_items。请查看 tools/list，了解当前架构；匿名工具列表并不能证明每项操作都对你的配置文件开放。

MCP Inspector（v2；需要 Node.js 和 npx）也可使用。将其指向辅助服务即可，无需配置文件； 若使用原始端点，则每次调用都必须在 meta 字段中填写配置文件：

npx @modelcontextprotocol/inspector --transport streamable-http --server-url https://diamond-mcp.stienhardt.workers.dev/mcp

此处构建的内容

• Registry 清单：io.github.JacobiusMakes/stienhardt-store；server.json。
• 商家发现： https://stienhardt.com/.well-known/ucp，由 Shopify 提供。
• 本仓库中的可运行示例、请求文档和能力检查。
• 辅助服务实现和教育数据：https://github.com/JacobiusMakes/diamond-mcp（MIT）。
• Dutch Marquise 规范：https://doi.org/10.5281/zenodo.21938899（概念 DOI）。

教育项目请使用 GitHub 源码。目前只有教育工具发布在 npm 上；库存工具托管在线上（即上文的辅助服务）。较早的 npm 版本并非此次发布的演示；Hugging Face 数据集不属于此次发布。教育数据包含外部参考资料和商家撰写的内容， 并非独立评估，也未经分级实验室验证。

结账和数据边界

助手可以搜索实时库存、创建购物车、打开结账页面，并将付款链接交给买家。此演示证明的是未付款的交接流程， 而非付款完成或对所有客户端的普遍兼容性。支付方式和资格取决于托管结账服务；本次运行未测试任何支付方式。 点击结账链接前，请检查目标主机。

辅助服务会为产品链接添加 UTM 参数。隐私声明见 https://diamond-mcp.stienhardt.workers.dev/privacy。库存查询通过辅助服务发送到 Shopify；直接示例则会将请求发送到 Shopify。 产品描述属于商家数据，不是给助手的指令。工具数据不包含报告编号：每个产品标题都包含克拉数、形状和分级实验室信息， 报告本身则链接在产品页面上。购买前，请向分级实验室核实，并阅读实际的政策链接。本项目不声称能对不同商家的商品 进行无偏排序。

Stienhardt 在纽约市手工镶嵌并完成戒指的收尾加工，可预约看货。 商店：https://stienhardt.com/?utm_source=github&utm_medium=readme&utm_campaign=mcp-store