Skip to main content
Glama
semorehq

@semore/mcp-commerce

Official
by semorehq

@semore/mcp-commerce

npm version license MCP Registry

Эталонный сервер Model Context Protocol (MCP) для трансграничной торговли K-продуктами — пять канонических инструментов, которые должен предоставлять любой агентский интернет-магазин.

#

Инструмент

Назначение

1

search_product

Поиск по каталогу K-продуктов (по ключевым словам / категории / цене / локали)

2

get_product

Получение полной информации об артикуле (название/описание с i18n, код ТН ВЭД, место отправки, срок выполнения)

3

create_cart

Создание корзины с указанием пункта назначения — возвращает детализированный расчет (промежуточный итог + доставка + пошлина + импортный налог)

4

quote_checkout

Повторный расчет стоимости корзины непосредственно перед оформлением (обновление валютного курса/пошлины), возвращает канонический VC CartMandate

5

submit_intent

Отправка VC AP2 IntentMandate + подписанного CartMandate, возвращает URL оформления заказа + подписанный PaymentMandate

Каноническая поверхность из 5 инструментов согласно спецификации Semore MCP commerce. Продакшн-сервер 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)

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 (PAN/CVV не передаются через MCP-сервер)

  • PIPA §28-8: активный процесс получения согласия на трансграничные операции

  • AP2: подписание мандата Ed25519 did:web:semore.net (сохранена 4-сторонняя модель карт)

  • UCP: эндпоинт /ucp/capability анонсирует commerce.search/commerce.cart/commerce.checkout

Справочная информация

Лицензия

Apache-2.0 — см. LICENSE.

Copyright (c) Команда основателей Semore.

Related MCP Connectors

Related MCP Servers