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 创始团队。

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Remote MCP for Universal Cart merchant readiness MCP, structured receipts, audit logs, and reviewer-

  • Federated commerce search across independent WooCommerce merchants. Keyless, read-only MCP server.

  • Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/semorehq/mcp-commerce'

If you have feedback or need assistance with the MCP directory API, please join our Discord server