@semore/mcp-commerce
Official@semore/mcp-commerce
Эталонный сервер Model Context Protocol (MCP) для трансграничной торговли K-продуктами — пять канонических инструментов, которые должен предоставлять любой агентский интернет-магазин.
# | Инструмент | Назначение |
1 |
| Поиск по каталогу K-продуктов (по ключевым словам / категории / цене / локали) |
2 |
| Получение полной информации об артикуле (название/описание с i18n, код ТН ВЭД, место отправки, срок выполнения) |
3 |
| Создание корзины с указанием пункта назначения — возвращает детализированный расчет (промежуточный итог + доставка + пошлина + импортный налог) |
4 |
| Повторный расчет стоимости корзины непосредственно перед оформлением (обновление валютного курса/пошлины), возвращает канонический VC CartMandate |
5 |
| Отправка VC AP2 IntentMandate + подписанного CartMandate, возвращает URL оформления заказа + подписанный PaymentMandate |
Каноническая поверхность из 5 инструментов согласно спецификации Semore MCP commerce. Продакшн-сервер 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) | LIVE | |
AP2 (Google) — IntentMandate / CartMandate / PaymentMandate VC | LIVE | |
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
Справочная информация
Спецификация 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.
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