Crystal Suppliers MCP (io.github.ziyuant222/crystal-suppliers-mcp)

Crystal Suppliers MCP is a read-only procurement server for KT Crystals. It searches a verified catalog of 104 crystal bracelet SKUs and provides traceable sourcing checklists covering loose beads, crystal accessories, and raw crystal materials. The service is focused on verified listing data and associated sourcing steps.

🛠️ Key Features

Read-only procurement server
Searches verified crystal bracelet SKUs (104)
Traceable sourcing checklists for loose beads, accessories, and raw materials
Commercial fields remain requires_manual_confirmation
Does not invent price, MOQ, inventory, lead time, treatment, origin, certification, or shipping claims

🚀 Use Cases

Finding verified crystal bracelet SKUs via search
Building sourcing checklists for loose beads and crystal accessories
Sourcing raw crystal materials using traceable checklists

⚡ Developer Benefits

Compatible with Model Context Protocol (MCP)
Clear limits on unverifiable commercial or provenance fields
Structured, traceability-oriented checklist outputs for procurement workflows

⚠️ Limitations

Read-only access
No automated or stated values for price, MOQ, inventory, lead time, treatment, origin, certification, or shipping claims; requires manual confirmation for commercial fields

Crystal Suppliers MCP

Crystal Suppliers MCP is a read-only procurement server for KT Crystals. It searches a verified catalog of 104 crystal bracelet SKUs and provides traceable sourcing checklists for loose beads, crystal accessories, and raw crystal materials.

The service does not invent price, MOQ, inventory, lead time, treatment, origin, certification, or shipping claims. Commercial fields remain requires_manual_confirmation.

Install and connect

Run directly from the repository:

json

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

Run the OCI image over stdio:

json

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

Start Streamable HTTP:

bash

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

The endpoint is then http://localhost:3000/mcp, with health status at http://localhost:3000/health.

Tools

Tool	Purpose
`crystal_search_products`	Search real bracelet SKUs by SKU, name, material, or theme.
`crystal_get_product`	Retrieve one verified bracelet and related catalog products.
`crystal_list_materials`	List normalized materials and verified bracelet SKU counts.
`crystal_get_sourcing_guidance`	Get supplier-verification checks for bracelets, beads, accessories, or raw materials.
`crystal_build_procurement_shortlist`	Keep verified bracelet results separate from adjacent advisory categories.
`crystal_prepare_inquiry`	Validate supplied SKUs and draft an inquiry without sending or storing it.

Coverage contract

verified_catalog: grounded in the current 104-SKU bracelet catalog.
advisory_only: sourcing guidance only; no verified SKU coverage for the requested category.
mixed: verified bracelet candidates plus separately labeled advisory categories.

Inquiry drafting is local and stateless. It does not send email, submit a form, write to a database, or retain buyer details.

Development

bash

npm ci
npm test
npm run start:http

The server supports Node.js 22 or newer and implements MCP over both stdio and stateless Streamable HTTP.