iikoServer MCP: 39 инструментов REST API iiko
iikoServer MCP Server
MCP-сервер для iikoServer REST API: товары, сотрудники, накладные, кассовые смены, инкассация и OLAP-отчеты, включая сырые запросы к любому эндпоинту
- 1 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- create_encashment вносит запись о движении наличных без отдельного подтверждения
- raw_request дает доступ к любому эндпоинту iikoServer, включая потенциально изменяющие данные
Установка
- Работает в
- Сервисы
Ручная установка
pip install -r requirements.txtУстановка зависимостей после клонирования репозитория.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- create_encashment вносит запись о движении наличных без отдельного подтверждения
- raw_request дает доступ к любому эндпоинту iikoServer, включая потенциально изменяющие данные
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер логинится в iikoServer по логину и паролю (SHA1 считается внутри), автоматически переавторизуется при истечении токена и корректно разлогинивается при завершении, освобождая лицензионное место. 39 инструментов разбиты по разделам: номенклатура и товары, сотрудники и роли, сущности и склады, входящие и исходящие накладные, списания, изменения меню, типы оплат, кассовые смены и платежи, включая create_encashment для внесения записи инкассации (движение наличных), ценовые категории и OLAP-отчеты с произвольными колонками и фильтрами или по сохраненным пресетам. Отдельный инструмент raw_request позволяет выполнить любой авторизованный запрос к iikoServer напрямую, если готового шортката нет. Все даты в формате ДД.ММ.ГГГГ, как принято в iiko, а ошибки возвращаются как результат инструмента, не как падение сервера.
Для кого. Для владельцев и управляющих ресторанами на iikoServer, которым нужен быстрый доступ к отчетам, номенклатуре и кассовым данным из чата с агентом.
Подходит, если
- Нужно посмотреть выручку, остатки, накладные или кассовые смены за период через агента
- Нужен произвольный OLAP-отчет с нужными колонками и фильтрами без похода в интерфейс iiko
- Нужен доступ к эндпоинту iikoServer, для которого еще нет готового инструмента, через raw_request
Не подходит, если
- Не хотите, чтобы агент мог создавать записи инкассации: create_encashment пишет кассовое движение без отдельного подтверждения на уровне сервера
- Нужен инструмент для iikoCloud или iikoTransport: этот сервер только для классического iikoServer
- Не готовы хранить пароль от iiko в переменной окружения: SHA1 считается локально, но исходный пароль все равно передается серверу
Пример запроса к агенту
Покажи выручку за сегодня на момент 18:00 и список кассовых смен за неделюMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
IIKO_URL- Базовый адрес сервера iikoServer, по умолчанию демо-адрес автора.
IIKO_LOGINобязательная, секрет- Логин пользователя iikoServer.
IIKO_PASSобязательная, секрет- Пароль пользователя, SHA1 считается сервером внутри.
Ограничения
Лицензия в репозитории не указана. Инструмент raw_request и create_encashment выполняются без встроенного шага подтверждения на уровне сервера, риск ошибочного вызова лежит на клиенте и пользователе. Проект от одного автора, README не описывает разделение на read-only и write-режим. Использует самоподписанные сертификаты без проверки (verify=False), что снижает защиту соединения, если сервер iiko настроен небезопасно.
Как отключить. Удалите блок iiko из конфигурации MCP клиента, сервер сам разлогинится при штатном завершении процесса.
Частые вопросы
Нужно ли самому считать хеш пароля?
Нет, сервер сам вычисляет SHA1 от переданного пароля, в переменную IIKO_PASS передается обычный пароль.
Что делает raw_request?
Выполняет любой авторизованный запрос к iikoServer напрямую, полезно для эндпоинтов, для которых нет готового инструмента, но требует осторожности.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
iiko — все инструментыMCP-сервер для REST API iikoServer: номенклатура, сотрудники, накладные, кассовые смены, OLAP-отчеты и выручка по заведениям
Легкий MCP-сервер для ручной отладки iikoTransport API (api-ru.iiko.services) с авторизацией v2 и универсальным инструментом произвольного запроса
iikocloud-mcp: 236 методов iikoCloud с гейтом записи
iikocloud-mcp
MCP-сервер для iikoCloud API с выбором нужного поднабора из 236 методов по домену, read-only по умолчанию и обязательным подтверждением перед любой записью
Многотенантный MCP-сервер для Pyrus
Pyrus AI Ecosystem — MCP Infrastructure
Enterprise MCP-сервер для Pyrus v4 API с многотенантностью, SQLite-хранением и метриками, внутри большого монорепозитория
MCP-сервер Apideck: агент работает с более чем 200 бизнес-системами: бухгалтерией, HRIS, CRM и файлами через единый API
Официальный MCP-сервер Cybozu: агент читает и меняет приложения, записи и пространства kintone через REST API.
Коротко о README
README перечисляет 39 инструментов по восьми разделам: система, номенклатура, сотрудники, сущности, документы, касса и платежи, цены, отчеты и OLAP, плюс raw_request. Даны переменные окружения, конфигурация для Hermes Agent, Claude Desktop и Cursor, формат дат ДД.ММ.ГГГГ и список функций: авто-реавторизация, корректный логаут, поддержка самоподписанных сертификатов, возврат ошибок как результата инструмента.