@semore/mcp-commerce
Official@semore/mcp-commerce
K-제품 해외 직구 커머스를 위한 참조 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 커머스 사양 기준). 프로덕션 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 | 네트워크 에이전트 표준 | 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://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 참조.
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