iikoServer MCP Server
MCP-сервер для REST API iikoServer: номенклатура, сотрудники, накладные, кассовые смены, OLAP-отчеты и выручка по заведениям
Установка
pip install -r requirements.txtВыполняйте в клоне https://github.com/simba87/iiko-server-mcp. Запуск: IIKO_URL=... IIKO_LOGIN=... IIKO_PASS=... python3 server.py.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер открывает агенту больше 40 инструментов для ресторанной системы iiko. Он читает номенклатуру, группы товаров, сотрудников, склады, поставщиков, входящие и исходящие накладные, списания, техкарты, кассовые смены и платежи. Для отчетов доступны OLAP-запросы, сохраненные пресеты и готовые сводки: выручка по заведениям, топ блюд, питание персонала, сравнение выручки по дням и список чеков. Есть инструменты записи техкарт и инкассаций, а также прямой вызов любого метода iikoServer. Сервер сам авторизуется и при завершении выходит из сессии, чтобы освободить лицензию.
Для кого. Владельцам и управляющим ресторанов, аналитикам и интеграторам, работающим с iiko.
Подходит, если
- Нужна выручка по точкам за день и сравнение со вчера
- Нужен топ блюд по выручке за период
- Нужно найти накладные поставщика или списания за неделю
Не подходит, если
- Нужен облачный iikoCloud API, а не iikoServer
- Агенту нельзя давать логин и пароль с правом изменения техкарт и кассы
Пример запроса к агенту
Сравни вчерашнюю выручку по всем заведениям с позавчерашней и покажи топ-10 блюд за неделюОграничения
Нужны адрес iikoServer, логин и пароль пользователя, пароль хранится в переменных окружения открытым текстом. Проверка SSL-сертификата по умолчанию выключена. Некоторые методы, например типы оплат, отсутствуют в части версий iikoServer, а питание персонала определяется по названию типа оплаты. Весь сервер умещается в один файл и опубликован одним коммитом, пакета нет.
Как отключить. Уберите блок iiko-server из конфигурации MCP-клиента. Если использовался отдельный пользователь iiko, отключите его.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| IIKO_URL обязательная | Адрес iikoServer |
| IIKO_LOGIN обязательная | Логин пользователя iiko |
| IIKO_PASS обязательная, секрет | Пароль пользователя iiko |
| IIKO_VENUE_MAP | Названия заведений для номеров касс |
| IIKO_VERIFY_SSL | Проверка SSL, по умолчанию false |
Проверка безопасности
- Может изменять техкарты и проводить инкассации в рабочей системе ресторана
- Хранит логин и пароль iiko в открытом виде, проверка SSL по умолчанию выключена
- Прямой вызов любого метода iikoServer в обход списка инструментов
Коротко о README
README на английском описывает возможности сервера, запуск локально через pip или в Docker в интерактивном режиме. Приведены переменные окружения и примеры конфигурации для Hermes Agent, Claude Desktop и Cursor. Все инструменты разбиты по группам, опасные операции записи помечены отдельно. Есть таблица форматов дат, список известных ограничений и порядок добавления нового инструмента. Лицензия MIT.
Частые вопросы
Займет ли сервер лицензию iiko?
Он открывает сессию при работе и при корректном завершении отправляет выход, чтобы освободить слот.
Как подписать кассы названиями заведений?
Задайте IIKO_VENUE_MAP в формате «Кафе A=4,Кафе B=5».
Похожие
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Скиллы и MCP-сервер для опционных трейдеров: котировки, технический анализ, греки, спреды, сканеры и портфель Interactive Brokers
Square MCP Server
Square Model Context Protocol Server
Официальный MCP-сервер Square: агент вызывает любые методы API Square, от каталога и клиентов до заказов и платежей
CLI и скилл для доступа агента к счету Т-Инвестиций: портфель, доходность, скринеры облигаций и заявки с подтверждением