@semore/mcp-commerce
Official@semore/mcp-commerce
Kプロダクトの越境EC向けリファレンス**Model Context Protocol (MCP)**サーバー — エージェント対応のストアフロントが備えるべき5つの標準ツールを提供します。
# | ツール | 目的 |
1 |
| Kプロダクトカタログ全体でのキーワード/カテゴリ/価格/ロケール検索 |
2 |
| 単一SKUの詳細取得(i18nタイトル/説明、HSコード、出荷元、リードタイム) |
3 |
| 配送先を指定したカート作成 — 明細付き見積もり(小計 + 送料 + 関税 + 輸入税)を返却 |
4 |
| チェックアウト直前のカート再見積もり(為替/関税の更新)、標準の CartMandate VC を返却 |
5 |
| AP2 IntentMandate VC + 署名済み CartMandate の送信、チェックアウトURL + 署名済み PaymentMandate を返却 |
標準の5ツールインターフェース(Semore MCP commerce spec に準拠)。 Semore MCPサーバーの本番環境は https://mcp.semore.net で稼働しています。 本OSSパッケージには、加盟店がローカルで統合を検証できるようにスキーマとリファレンスハンドラーが含まれています。
インストール
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) | LIVE | |
AP2 (Google) — IntentMandate / CartMandate / PaymentMandate VC | LIVE | |
UCP (Google + Shopify) | LIVE | |
Visa TAP / MC Agent Pay | ネットワークエージェント標準 | フェーズ1 (登録) |
コンプライアンスと信頼性
PCI: SAQ-A(MCPサーバーを介したPAN/CVVの通過なし)
PIPA §28-8: 越境同意フローが有効
AP2:
did:web:semore.netEd25519 マンダート署名(4者間カードモデルを維持)UCP:
/ucp/capabilityエンドポイントでcommerce.search/commerce.cart/commerce.checkoutをアドバタイズ
リファレンス
公式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 を参照してください。
Copyright (c) Semore Founding Team.
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