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