Crystal Suppliers MCP

Crystal Suppliers MCP

Crystal Suppliers MCP é um servidor de compras somente leitura para KT Crystals. Ele pesquisa um catálogo verificado de 104 SKUs de pulseiras de cristal e fornece listas de verificação de fornecimento rastreáveis para contas soltas, acessórios de cristal e materiais brutos de cristal.

O serviço não inventa preço, MOQ, estoque, prazo de entrega, tratamento, origem, certificação ou alegações de envio. Os campos comerciais permanecem requires_manual_confirmation.

Instalar e conectar

Execute diretamente do repositório:

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

Execute a imagem OCI via stdio:

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

Inicie o Streamable HTTP:

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

O endpoint é então http://localhost:3000/mcp, com status de saúde em http://localhost:3000/health.

Ferramentas

Ferramenta	Finalidade
crystal_search_products	Pesquisar SKUs reais de pulseiras por SKU, nome, material ou tema.
crystal_get_product	Recuperar uma pulseira verificada e produtos de catálogo relacionados.
crystal_list_materials	Listar materiais normalizados e contagens verificadas de SKUs de pulseiras.
crystal_get_sourcing_guidance	Obter verificações de fornecedor para pulseiras, contas, acessórios ou materiais brutos.
crystal_build_procurement_shortlist	Manter resultados verificados de pulseiras separados de categorias consultivas adjacentes.
crystal_prepare_inquiry	Validar SKUs fornecidos e elaborar uma consulta sem enviá-la ou armazená-la.

Contrato de cobertura

• verified_catalog: fundamentado no catálogo atual de 104 SKUs de pulseiras.
• advisory_only: apenas orientação de fornecimento; sem cobertura verificada de SKU para a categoria solicitada.
• mixed: candidatos verificados de pulseiras mais categorias consultivas rotuladas separadamente.

A elaboração de consultas é local e sem estado. Ela não envia e-mail, não submete formulário, não grava em banco de dados e não retém dados do comprador.

Desenvolvimento

npm ci
npm test
npm run start:http

O servidor suporta Node.js 22 ou mais recente e implementa MCP sobre stdio e Streamable HTTP sem estado.