MCP-satu.kz

Краткое назначение

MCP-satu.kz — MCP-сервер для публичных API EVO-порталов satu.kz, prom.ua, deal.by и vendigo.ro.

Бизнес-задача

Маркетплейс-операции часто требуют работы с товарами, категориями, импортами, файлами и API. Проект превращает API EVO-порталов в набор AI-доступных инструментов и добавляет локальную проверку файлов до загрузки.

Техническое решение

Сервер читает OpenAPI-спецификацию и автоматически публикует MCP tools для endpoint'ов. Дополнительно реализована проверка Excel/CSV-файлов перед импортом товаров: обязательные поля, единицы измерения, цены, категории и ошибки валидации.

Архитектура

MCP server для AI-клиентов;
OpenAPI parser и генерация tools;
bearer authorization;
поддержка JSON, form-urlencoded и multipart/form-data;
локальная Excel/CSV validation pipeline;
progress-файлы, manifest, stop-файл и логи для длительных импортов;
поддержка нескольких порталов через разные tool prefixes.

Стек

Node.js, TypeScript, MCP, OpenAPI, AJV, Zod, Excel/CSV validation, EVO public API.

Интеграции

satu.kz;
prom.ua;
deal.by;
vendigo.ro;
Excel/CSV import workflows.

Ограничения и риски

Проект протестирован на satu.kz; другие EVO-порталы используют похожий API, но требуют отдельной проверки в реальных условиях.

Что показывает в портфолио

Marketplace automation, OpenAPI-driven tooling, data validation и прикладную e-commerce интеграцию.

Ссылка

https://github.com/NohchiyBors/MCP-satu.kz