@semore/mcp-commerce

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.

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)

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

• Especificación MCP: https://modelcontextprotocol.io

• Registro MCP oficial: https://registry.modelcontextprotocol.io

• Endpoint de producción de Semore: https://mcp.semore.net

• Libro blanco (v0.1 en progreso): https://semore.net/docs/whitepaper/v0.1

• Contacto: semore.hq@gmail.com · GitHub @semorehq

Licencia

Apache-2.0: consulte LICENSE.

Copyright (c) Equipo fundador de Semore.