Skip to main content
Glama
semorehq

@semore/mcp-commerce

Official
by semorehq

@semore/mcp-commerce

npm version license MCP Registry

用于 K-product 跨境电商的参考 模型上下文协议 (MCP) 服务器 — 每个支持智能体的店面都应具备的五个规范化工具。

#

工具

用途

1

search_product

在 K-product 目录中进行关键词/类别/价格/地区搜索

2

get_product

获取单个 SKU 的完整详情(国际化标题/描述、HS 编码、发货地、交付周期)

3

create_cart

创建带有目的地的购物车 — 返回分项报价(小计 + 运费 + 关税 + 进口税)

4

quote_checkout

在结账前立即重新报价购物车(刷新汇率/关税),返回规范的 CartMandate VC

5

submit_intent

提交 AP2 IntentMandate VC + 已签名的 CartMandate,返回结账 URL + 已签名的 PaymentMandate

规范的 5 工具界面,遵循 Semore MCP 电商规范。 生产环境 Semore MCP 服务器运行于 https://mcp.semore.net。 此开源包提供 模式 + 参考处理程序,以便商家在本地验证集成。

安装

npm install @semore/mcp-commerce zod

Related MCP server: SlimWeb Client MCP

使用已发布的 MCP 服务器 (Claude Desktop / ChatGPT / Gemini)

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

或者通过 官方 MCP 注册表 发现:

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

使用方法 — 仅模式(验证集成)

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);

使用方法 — 启动最小化 MCP 服务器

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

配套适配器 (5 协议多适配器)

适配器

规范

状态

@semore/acp-adapter

ACP (Stripe / PayPal)

已上线

@semore/ap2-adapter

AP2 (Google) — IntentMandate / CartMandate / PaymentMandate VC

已上线

@semore/ucp-adapter

UCP (Google + Shopify)

已上线

Visa TAP / MC Agent Pay

网络智能体标准

第一阶段 (注册)

合规与信任

  • PCI: SAQ-A (无 PAN/CVV 通过 MCP 服务器传输)

  • PIPA §28-8: 跨境同意流程已激活

  • AP2: did:web:semore.net Ed25519 授权签名(保留四方卡模型)

  • UCP: /ucp/capability 端点通告 commerce.search/commerce.cart/commerce.checkout

参考

许可证

Apache-2.0 — 参见 LICENSE。

版权所有 (c) Semore 创始团队。

Related MCP Connectors

Related MCP Servers