@semore/mcp-commerce
Official@semore/mcp-commerce
用于 K-product 跨境电商的参考 模型上下文协议 (MCP) 服务器 — 每个支持智能体的店面都应具备的五个规范化工具。
# | 工具 | 用途 |
1 |
| 在 K-product 目录中进行关键词/类别/价格/地区搜索 |
2 |
| 获取单个 SKU 的完整详情(国际化标题/描述、HS 编码、发货地、交付周期) |
3 |
| 创建带有目的地的购物车 — 返回分项报价(小计 + 运费 + 关税 + 进口税) |
4 |
| 在结账前立即重新报价购物车(刷新汇率/关税),返回规范的 CartMandate VC |
5 |
| 提交 AP2 IntentMandate VC + 已签名的 CartMandate,返回结账 URL + 已签名的 PaymentMandate |
规范的 5 工具界面,遵循 Semore MCP 电商规范。 生产环境 Semore MCP 服务器运行于 https://mcp.semore.net。 此开源包提供 模式 + 参考处理程序,以便商家在本地验证集成。
安装
npm install @semore/mcp-commerce zodRelated 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 协议多适配器)
适配器 | 规范 | 状态 |
ACP (Stripe / PayPal) | 已上线 | |
AP2 (Google) — IntentMandate / CartMandate / PaymentMandate VC | 已上线 | |
UCP (Google + Shopify) | 已上线 | |
Visa TAP / MC Agent Pay | 网络智能体标准 | 第一阶段 (注册) |
合规与信任
PCI: SAQ-A (无 PAN/CVV 通过 MCP 服务器传输)
PIPA §28-8: 跨境同意流程已激活
AP2:
did:web:semore.netEd25519 授权签名(保留四方卡模型)UCP:
/ucp/capability端点通告commerce.search/commerce.cart/commerce.checkout
参考
MCP 规范: https://modelcontextprotocol.io
官方 MCP 注册表: https://registry.modelcontextprotocol.io
Semore 生产环境端点: https://mcp.semore.net
白皮书 (v0.1 进行中): https://semore.net/docs/whitepaper/v0.1
联系方式:
semore.hq@gmail.com· GitHub @semorehq
许可证
Apache-2.0 — 参见 LICENSE。
版权所有 (c) 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