@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.
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.-