Vaanzari Commerce
MCP oficial para el descubrimiento de saris banarasi y flujos de compra autorizados de Vaanzari.
Documentación
Vaanzari Commerce MCP + WebMCP
Guía de conexión pública para Vaanzari Commerce MCP y la implementación de referencia WebMCP nativa del navegador para compras de saris asistidas por agentes.
Aplicación en vivo
MCP remoto
Conecta un cliente MCP compatible a https://vaanzari.com/mcp usando Streamable HTTP. Los metadatos del repositorio y los ejemplos siguen disponibles para ese protocolo:
- tarjeta del servidor
- ejemplo de cliente genérico
- configuración de Cursor
- guía de conexión
- guía de herramientas MCP remoto
El MCP remoto y el WebMCP del navegador son complementarios: los clientes remotos se conectan al servicio de Vaanzari, mientras que WebMCP expone herramientas nativas de la página dentro de navegadores compatibles.
Comienza con el inicio rápido de MCP/WebMCP para elegir la superficie de integración que se adapte a tu cliente.
WebMCP del navegador
Vaanzari registra seis herramientas nativas del navegador a través de document.modelContext.registerTool(...):
search-sareesget-sareecompare-sareesopen-sareeadd-saree-to-cartopen-cart
Un agente puede buscar, comparar, navegar y añadir un producto público disponible al estado visible del carrito. El humano conserva el juicio final, la información personal, el pago, el proceso de compra y la confirmación del pedido.
Inicio rápido
npm install
npm run dev
Abre http://localhost:5173. Esta demo de referencia independiente utiliza una pequeña instantánea de datos de prueba segura y pública de los campos del catálogo visibles para el comprador. No se requiere API privada, credenciales, cuentas, pagos ni dependencias de despliegue.
npm run typecheck
npm run lint
npm test
npm run build
npm run check:webmcp
npm run secret-scan
Verificación en el navegador
Abre /webmcp-diagnostics en un navegador compatible con WebMCP. Informa sobre el contexto seguro, document.modelContext, registerTool(), getTools() opcional, nombres esperados, nombres faltantes y estado LISTO/NO LISTO sin leer el almacenamiento del navegador ni el estado del cliente.
Para pruebas en vivo, usa ChatGPT Desktop Site Tools o Chrome 149+ con WebMCP habilitado. Pregunta: "Encuentra saris de Banarasi por menos de ₹20,000", compara los resultados, abre uno, añádelo al carrito y luego abre el carrito. Consulta verificación en el navegador. El respaldo de Safari puede mostrar el comportamiento normal de la tienda, pero no es evidencia de registro WebMCP.
Arquitectura
src/webmcp/register.ts es la pieza central de las herramientas del navegador. Depende únicamente de un PublicCatalogClient, un adaptador de navegación del navegador y un adaptador de carrito del navegador. src/demo/ proporciona datos de prueba y estado de React para la reproducción local. Consulta arquitectura y referencia de herramientas.
Límite público/privado
La plataforma comercial de producción de Vaanzari permanece en un repositorio privado separado. Este repositorio contiene el código fuente WebMCP nativo del navegador ejecutable de forma independiente, el adaptador de datos de prueba seguro y público, la interfaz de demostración, diagnósticos, pruebas y documentación.
No contiene credenciales de producción, implementación de pagos, código de backend privado, manejo de datos de clientes, interfaces administrativas, infraestructura, configuración de despliegue ni código de base de datos. Los límites de seguridad establecen restricciones deliberadas.
Archivo de Devpost
El material de procedencia y envío del período de desafío sigue disponible para contexto histórico, no como propósito principal del repositorio: trabajo del desafío, procedencia y lista de verificación de envío.
Licencia y marcas comerciales
El software es Apache-2.0. Los derechos de marca y fotos de productos son separados; consulta TRADEMARKS.md.