iikoServer MCP Server
MCP-сервер для REST API iikoServer: номенклатура, сотрудники, накладные, кассовые смены, OLAP-отчеты и выручка по заведениям
- 2 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Может изменять техкарты и проводить инкассации в рабочей системе ресторана
- Хранит логин и пароль iiko в открытом виде, проверка SSL по умолчанию выключена
- Прямой вызов любого метода iikoServer в обход списка инструментов
Установка
- Работает в
- Сервисы
Ручная установка
pip install -r requirements.txtВыполняйте в клоне https://github.com/simba87/iiko-server-mcp. Запуск: IIKO_URL=... IIKO_LOGIN=... IIKO_PASS=... python3 server.py.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Может изменять техкарты и проводить инкассации в рабочей системе ресторана
- Хранит логин и пароль iiko в открытом виде, проверка SSL по умолчанию выключена
- Прямой вызов любого метода iikoServer в обход списка инструментов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер открывает агенту больше 40 инструментов для ресторанной системы iiko. Он читает номенклатуру, группы товаров, сотрудников, склады, поставщиков, входящие и исходящие накладные, списания, техкарты, кассовые смены и платежи. Для отчетов доступны OLAP-запросы, сохраненные пресеты и готовые сводки: выручка по заведениям, топ блюд, питание персонала, сравнение выручки по дням и список чеков. Есть инструменты записи техкарт и инкассаций, а также прямой вызов любого метода iikoServer. Сервер сам авторизуется и при завершении выходит из сессии, чтобы освободить лицензию.
Для кого. Владельцам и управляющим ресторанов, аналитикам и интеграторам, работающим с iiko.
Подходит, если
- Нужна выручка по точкам за день и сравнение со вчера
- Нужен топ блюд по выручке за период
- Нужно найти накладные поставщика или списания за неделю
Не подходит, если
- Нужен облачный iikoCloud API, а не iikoServer
- Агенту нельзя давать логин и пароль с правом изменения техкарт и кассы
Пример запроса к агенту
Сравни вчерашнюю выручку по всем заведениям с позавчерашней и покажи топ-10 блюд за неделюMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
IIKO_URLобязательная- Адрес iikoServer
IIKO_LOGINобязательная- Логин пользователя iiko
IIKO_PASSобязательная, секрет- Пароль пользователя iiko
IIKO_VENUE_MAP- Названия заведений для номеров касс
IIKO_VERIFY_SSL- Проверка SSL, по умолчанию false
Ограничения
Нужны адрес iikoServer, логин и пароль пользователя, пароль хранится в переменных окружения открытым текстом. Проверка SSL-сертификата по умолчанию выключена. Некоторые методы, например типы оплат, отсутствуют в части версий iikoServer, а питание персонала определяется по названию типа оплаты. Весь сервер умещается в один файл и опубликован одним коммитом, пакета нет.
Как отключить. Уберите блок iiko-server из конфигурации MCP-клиента. Если использовался отдельный пользователь iiko, отключите его.
Частые вопросы
Займет ли сервер лицензию iiko?
Он открывает сессию при работе и при корректном завершении отправляет выход, чтобы освободить слот.
Как подписать кассы названиями заведений?
Задайте IIKO_VENUE_MAP в формате «Кафе A=4,Кафе B=5».
Чем iikoServer MCP Server отличается от других MCP для iiko?
Сервер открывает агенту больше 40 инструментов REST API iikoServer: номенклатура, группы товаров, сотрудники, склады, поставщики, входящие и исходящие накладные, списания, техкарты, кассовые смены, OLAP-отчеты и выручка по заведениям.
Занимает ли сервер лицензию iiko и как подписать кассы названиями заведений?
Да, пока сервер подключен, он занимает слот лицензии iiko, а при остановке выходит из системы и освобождает его. Названия заведений для касс задаются в конфигурации сервера, см. README. Установка: pip install -r requirements.txt. Работает в Claude Desktop и Cursor. Риск высокий.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
iiko — все инструментыiikoServer MCP: 39 инструментов REST API iiko
iikoServer MCP Server
MCP-сервер для iikoServer REST API: товары, сотрудники, накладные, кассовые смены, инкассация и OLAP-отчеты, включая сырые запросы к любому эндпоинту
iikocloud-mcp: 236 методов iikoCloud с гейтом записи
iikocloud-mcp
MCP-сервер для iikoCloud API с выбором нужного поднабора из 236 методов по домену, read-only по умолчанию и обязательным подтверждением перед любой записью
Легкий MCP-сервер для ручной отладки iikoTransport API (api-ru.iiko.services) с авторизацией v2 и универсальным инструментом произвольного запроса
Многотенантный MCP-сервер для Pyrus
Pyrus AI Ecosystem — MCP Infrastructure
Enterprise MCP-сервер для Pyrus v4 API с многотенантностью, SQLite-хранением и метриками, внутри большого монорепозитория
MCP-сервер для JSON API 1.2 МойСклад: остатки, заказы, отчеты о прибыли и создание документов за двумя уровнями защиты
Официальный локальный MCP-сервер Intuit: агент ищет и создает счета, платежи и контрагентов в QuickBooks Online, строит отчеты
Из блога
Коротко о README
README на английском описывает возможности сервера, запуск локально через pip или в Docker в интерактивном режиме. Приведены переменные окружения и примеры конфигурации для Hermes Agent, Claude Desktop и Cursor. Все инструменты разбиты по группам, опасные операции записи помечены отдельно. Есть таблица форматов дат, список известных ограничений и порядок добавления нового инструмента. Лицензия MIT.