@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 创始团队。
This server cannot be deployed
Maintenance
Related MCP Connectors
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, and more.
MCP server for Product Management
Remote MCP server for product discovery catalog and retrieving product details.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA 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.1-
- FlicenseNot gradedqualityDmaintenanceMCP server exposing Shopify commerce backend with ~22 typed tools for orders, inventory, logistics, and fulfillment, including read/write separation and structured errors.-