@semore/mcp-commerce
Official@semore/mcp-commerce
Referenz-Model Context Protocol (MCP)-Server für den grenzüberschreitenden K-Produkt-Handel — fünf kanonische Tools, die jedes agentenfähige Storefront bereitstellen sollte.
# | Tool | Zweck |
1 |
| Suche nach Schlüsselwörtern / Kategorien / Preisen / Gebietsschema im K-Produktkatalog |
2 |
| Abrufen der vollständigen Details einer SKU (i18n-Titel/Beschreibung, HS-Code, Versandort, Lieferzeit) |
3 |
| Warenkorb mit Zielort erstellen — gibt ein detailliertes Angebot zurück (Zwischensumme + Versand + Zoll + Einfuhrsteuer) |
4 |
| Warenkorb unmittelbar vor dem Checkout neu kalkulieren (Aktualisierung von FX/Zoll), gibt kanonisches CartMandate VC zurück |
5 |
| AP2 IntentMandate VC + signiertes CartMandate einreichen, gibt Checkout-URL + signiertes PaymentMandate zurück |
Kanonische 5-Tool-Oberfläche gemäß der Semore MCP Commerce-Spezifikation. Der produktive Semore MCP-Server läuft unter https://mcp.semore.net. Dieses OSS-Paket enthält Schemas + Referenz-Handler, damit Händler Integrationen lokal validieren können.
Installation
npm install @semore/mcp-commerce zodRelated MCP server: SlimWeb Client MCP
Verwendung des veröffentlichten MCP-Servers (Claude Desktop / ChatGPT / Gemini)
// Claude Desktop config — `claude_desktop_config.json`
{
"mcpServers": {
"semore": {
"command": "npx",
"args": ["-y", "@semore/mcp-commerce"]
}
}
}Oder entdecken Sie ihn über die offizielle MCP-Registry:
curl "https://registry.modelcontextprotocol.io/v0/servers?search=semore"
# → io.github.semorehq/mcp-commerce@0.4.2Verwendung — nur Schema (Integrationen validieren)
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);Verwendung — einen minimalen MCP-Server starten
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).Begleitende Adapter (5-Protokoll-Multi-Adapter)
Adapter | Spezifikation | Status |
ACP (Stripe / PayPal) | LIVE | |
AP2 (Google) — IntentMandate / CartMandate / PaymentMandate VC | LIVE | |
UCP (Google + Shopify) | LIVE | |
Visa TAP / MC Agent Pay | Netzwerk-Agenten-Standards | Phase 1 (Anmeldung) |
Compliance & Vertrauen
PCI: SAQ-A (kein PAN/CVV-Transit durch den MCP-Server)
PIPA §28-8: Grenzüberschreitender Zustimmungsfluss aktiv
AP2:
did:web:semore.netEd25519 Mandat-Signierung (4-Parteien-Kartenmodell beibehalten)UCP:
/ucp/capabilityEndpunkt bewirbtcommerce.search/commerce.cart/commerce.checkout
Referenz
MCP-Spezifikation: https://modelcontextprotocol.io
Offizielle MCP-Registry: https://registry.modelcontextprotocol.io
Semore Produktions-Endpunkt: https://mcp.semore.net
Whitepaper (v0.1 in Arbeit): https://semore.net/docs/whitepaper/v0.1
Kontakt:
semore.hq@gmail.com· GitHub @semorehq
Lizenz
Apache-2.0 — siehe LICENSE.
Copyright (c) Semore Founding Team.
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