Skip to main content
Glama
@semore/mcp-commerce

@semore/mcp-commerce

Official
by semorehq

@semore/mcp-commerce

npm version license MCP Registry

Servidor de referencia del Protocolo de Contexto de Modelo (MCP) para comercio transfronterizo de productos K: cinco herramientas canónicas que toda tienda preparada para agentes debería exponer.

#

Herramienta

Propósito

1

search_product

Búsqueda por palabra clave / categoría / precio / ubicación en el catálogo de productos K

2

get_product

Obtener los detalles completos de un SKU (título/descripción i18n, código SA, origen, plazo)

3

create_cart

Crear carrito con destino: devuelve cotización detallada (subtotal + envío + aranceles + impuestos)

4

quote_checkout

Recotizar carrito inmediatamente antes del pago (actualiza FX/aranceles), devuelve CartMandate VC canónico

5

submit_intent

Enviar AP2 IntentMandate VC + CartMandate firmado, devuelve URL de pago + PaymentMandate firmado

Superficie de 5 herramientas canónicas según la especificación de comercio MCP de Semore. El servidor MCP de producción de Semore se ejecuta en https://mcp.semore.net. Este paquete de código abierto incluye esquemas + controladores de referencia para que los comerciantes puedan validar integraciones localmente.

Instalación

npm install @semore/mcp-commerce zod

Related MCP server: SlimWeb Client MCP

Usar el servidor MCP publicado (Claude Desktop / ChatGPT / Gemini)

// Claude Desktop config — `claude_desktop_config.json`
{
  "mcpServers": {
    "semore": {
      "command": "npx",
      "args": ["-y", "@semore/mcp-commerce"]
    }
  }
}

O descúbralo a través del Registro MCP oficial:

curl "https://registry.modelcontextprotocol.io/v0/servers?search=semore"
# → io.github.semorehq/mcp-commerce@0.4.2

Uso: solo esquema (validar integraciones)

import { searchProductTool } from "@semore/mcp-commerce/tools/search-product";

const parsed = searchProductTool.inputSchema.parse({
  q: "sunscreen",
  lang: "en",
  category: "kbeauty",
  limit: 10,
});

const result = await searchProductTool.handler(parsed);

Uso: iniciar un servidor MCP mínimo

import { createMcpServer } from "@semore/mcp-commerce";

const server = createMcpServer({
  // Wire your own catalog / cart / order resolvers here.
  // Default skeleton resolvers return deterministic fixtures useful for local tests.
});

// Then expose over your preferred transport (stdio, streamable-http, SSE).

Adaptadores complementarios (adaptador múltiple de 5 protocolos)

Adaptador

Especificación

Estado

@semore/acp-adapter

ACP (Stripe / PayPal)

ACTIVO

@semore/ap2-adapter

AP2 (Google) — IntentMandate / CartMandate / PaymentMandate VC

ACTIVO

@semore/ucp-adapter

UCP (Google + Shopify)

ACTIVO

Visa TAP / MC Agent Pay

Estándares de agentes de red

Fase 1 (registro)

Cumplimiento y confianza

  • PCI: SAQ-A (ningún PAN/CVV transita a través del servidor MCP)

  • PIPA §28-8: flujo de consentimiento transfronterizo activo

  • AP2: firma de mandato Ed25519 did:web:semore.net (modelo de tarjeta de 4 partes preservado)

  • UCP: el endpoint /ucp/capability anuncia commerce.search/commerce.cart/commerce.checkout

Referencia

Licencia

Apache-2.0: consulte LICENSE.

Copyright (c) Equipo fundador de Semore.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers