Skip to main content
Glama
semorehq

@semore/mcp-commerce

Official
by semorehq

@semore/mcp-commerce

npm version license MCP Registry

Kプロダクトの越境EC向けリファレンス**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 commerce spec に準拠)。 Semore MCPサーバーの本番環境は https://mcp.semore.net で稼働しています。 本OSSパッケージには、加盟店がローカルで統合を検証できるようにスキーマとリファレンスハンドラーが含まれています。

インストール

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)

LIVE

@semore/ap2-adapter

AP2 (Google) — IntentMandate / CartMandate / PaymentMandate VC

LIVE

@semore/ucp-adapter

UCP (Google + Shopify)

LIVE

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