@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.

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 zod

Related 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.2

Verwendung — 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)

Compliance & Vertrauen

• PCI: SAQ-A (kein PAN/CVV-Transit durch den MCP-Server)

• PIPA §28-8: Grenzüberschreitender Zustimmungsfluss aktiv

• AP2: did:web:semore.net Ed25519 Mandat-Signierung (4-Parteien-Kartenmodell beibehalten)

• UCP: /ucp/capability Endpunkt bewirbt commerce.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.