Skip to main content
Glama
semorehq

@semore/mcp-commerce

Official
by semorehq

@semore/mcp-commerce

npm version license MCP Registry

K-제품 해외 직구 커머스를 위한 참조 Model Context Protocol (MCP) 서버 — 모든 에이전트 지원 스토어프론트가 갖추어야 할 5가지 표준 도구입니다.

#

도구

목적

1

search_product

K-제품 카탈로그 내 키워드 / 카테고리 / 가격 / 로케일 검색

2

get_product

단일 SKU의 전체 상세 정보 가져오기 (i18n 제목/설명, HS 코드, 발송지, 리드 타임)

3

create_cart

목적지를 포함한 장바구니 생성 — 항목별 견적 반환 (소계 + 배송비 + 관세 + 수입세)

4

quote_checkout

결제 직전 장바구니 재견적 (환율/관세 갱신), 표준 CartMandate VC 반환

5

submit_intent

AP2 IntentMandate VC + 서명된 CartMandate 제출, 결제 URL + 서명된 PaymentMandate 반환

표준 5-도구 인터페이스 (Semore MCP 커머스 사양 기준). 프로덕션 Semore MCP 서버는 https://mcp.semore.net에서 실행됩니다. 이 오픈 소스 패키지는 가맹점이 로컬에서 통합을 검증할 수 있도록 스키마 + 참조 핸들러를 제공합니다.

설치

npm install @semore/mcp-commerce zod

Related 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-프로토콜 멀티 어댑터)

어댑터

사양

상태

@semore/acp-adapter

ACP (Stripe / PayPal)

라이브

@semore/ap2-adapter

AP2 (Google) — IntentMandate / CartMandate / PaymentMandate VC

라이브

@semore/ucp-adapter

UCP (Google + Shopify)

라이브

Visa TAP / MC Agent Pay

네트워크 에이전트 표준

1단계 (가입)

규정 준수 및 신뢰

  • PCI: SAQ-A (MCP 서버를 통한 PAN/CVV 전송 없음)

  • PIPA §28-8: 해외 직구 동의 절차 활성화

  • AP2: did:web:semore.net Ed25519 위임 서명 (4자 카드 모델 유지)

  • UCP: /ucp/capability 엔드포인트가 commerce.search/commerce.cart/commerce.checkout 광고

참조

라이선스

Apache-2.0 — LICENSE 참조.

Copyright (c) Semore Founding Team.

Related MCP Connectors

Related MCP Servers