English Français العربية

Crystal Suppliers MCP

Registre officiel Recherche et web

Search verified crystal bracelets and source beads, accessories, and raw materials.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http crystal-suppliers-mcp 'https://ktcrystals.com/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "crystal-suppliers-mcp": {
            "type": "http",
            "url": "https://ktcrystals.com/mcp"
        }
    }
}
OCI package ghcr.io/ziyuant222/crystal-suppliers-mcp:0.1.0
Claude Code 
claude mcp add crystal-suppliers-mcp -- docker run -i --rm ghcr.io/ziyuant222/crystal-suppliers-mcp:0.1.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "crystal-suppliers-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/ziyuant222/crystal-suppliers-mcp:0.1.0"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Crystal Suppliers MCP
  2. Install and connect
  3. Tools
  4. Coverage contract
  5. Development

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:

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

Run the OCI image over stdio:

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

Start Streamable HTTP:

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

ToolPurpose
crystal_search_productsSearch real bracelet SKUs by SKU, name, material, or theme.
crystal_get_productRetrieve one verified bracelet and related catalog products.
crystal_list_materialsList normalized materials and verified bracelet SKU counts.
crystal_get_sourcing_guidanceGet supplier-verification checks for bracelets, beads, accessories, or raw materials.
crystal_build_procurement_shortlistKeep verified bracelet results separate from adjacent advisory categories.
crystal_prepare_inquiryValidate 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

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.

Questions fréquentes

Qu'est-ce que Crystal Suppliers MCP ?

Search verified crystal bracelets and source beads, accessories, and raw materials.

Comment installer Crystal Suppliers MCP ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http crystal-suppliers-mcp 'https://ktcrystals.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Crystal Suppliers MCP ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Crystal Suppliers MCP est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Crystal Suppliers MCP ?

Il est publié par ziyuant222. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.