Crystal Suppliers MCP

Crystal Suppliers MCP

Crystal Suppliers MCP 是面向 KT Crystals 的只读采购服务。它可搜索包含 104 款水晶手串 SKU 的经核实目录，并为散珠、水晶配饰和原石材料提供可追溯的采购核查清单。

该服务不会臆造价格、最低起订量、库存、交货时间、处理方式、产地、认证或运输信息。商业字段均标记为 requires_manual_confirmation。

安装和连接

直接从代码仓库运行：

{
  "mcpServers": {
    "crystal-suppliers": {
      "command": "node",
      "args": ["/absolute/path/to/crystal-suppliers-mcp/src/index.mjs"]
    }
  }
}

通过 stdio 运行 OCI 镜像：

{
  "mcpServers": {
    "crystal-suppliers": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/ziyuant222/crystal-suppliers-mcp:0.1.0"
      ]
    }
  }
}

启动 Streamable HTTP：

docker run --rm -p 3000:3000 \
  ghcr.io/ziyuant222/crystal-suppliers-mcp:0.1.0 --http

端点为 http://localhost:3000/mcp，健康状态位于 http://localhost:3000/health。

工具

工具	用途
crystal_search_products	按 SKU、名称、材质或主题搜索真实手串 SKU。
crystal_get_product	获取一款经核实的手串及相关目录产品。
crystal_list_materials	列出规范化材质及经核实的手串 SKU 数量。
crystal_get_sourcing_guidance	获取针对手串、散珠、配饰或原石材料的供应商核查事项。
crystal_build_procurement_shortlist	将经核实的手串结果与相邻咨询类别分开列出。
crystal_prepare_inquiry	验证提供的 SKU 并起草询价，不会发送或存储询价。

覆盖范围约定

• verified_catalog：基于当前包含 104 款手串 SKU 的目录。
• advisory_only：仅提供采购指导；所请求类别没有经核实的 SKU 覆盖。
• mixed：经核实的手串候选项与单独标注的咨询类别并列提供。

询价起草在本地完成且不保留状态。它不会发送电子邮件、提交表单、写入数据库或留存买家详情。

开发

npm ci
npm test
npm run start:http

该服务端支持 Node.js 22 或更高版本，并通过 stdio 和无状态 Streamable HTTP 实现 MCP。