@semore/mcp-commerce
Official@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.
# | Herramienta | Propósito |
1 |
| Búsqueda por palabra clave / categoría / precio / ubicación en el catálogo de productos K |
2 |
| Obtener los detalles completos de un SKU (título/descripción i18n, código SA, origen, plazo) |
3 |
| Crear carrito con destino: devuelve cotización detallada (subtotal + envío + aranceles + impuestos) |
4 |
| Recotizar carrito inmediatamente antes del pago (actualiza FX/aranceles), devuelve CartMandate VC canónico |
5 |
| 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 zodRelated 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.2Uso: 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 |
ACP (Stripe / PayPal) | ACTIVO | |
AP2 (Google) — IntentMandate / CartMandate / PaymentMandate VC | ACTIVO | |
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/capabilityanunciacommerce.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.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, and more.
Sample shop MCP server: paginated search, idempotent orders, guarded cancellation. Four languages.
MCP server for Product Management
Related MCP Servers
- FlicenseNot gradedqualityFmaintenanceA Model Context Protocol server that enables AI assistants to interact with a complete e-commerce application, providing authentication, product browsing, and shopping cart management through standardized MCP tools.-
- FlicenseNot gradedqualityCmaintenanceConsumer-side MCP server for Webless storefront operations, enabling catalog browsing, product search, and order lookup via tools.-
- FlicenseNot gradedqualityDmaintenanceA proof of concept MCP server that gives AI agents business context for e-commerce operations including orders, inventory, logistics, returns, claims, and payments.2-
- AlicenseNot gradedqualityDmaintenanceMCP server exposing Shopify commerce backend with ~22 typed tools for orders, inventory, logistics, and fulfillment, including read/write separation and structured errors.ISC