ivnvxd/mcp-server-odoo

MCP-сервер, позволяющий AI-ассистентам безопасно взаимодействовать с Odoo ERP через стандартизированные ресурсы и инструменты для получения и изменения данных.

MCP⭐ 406Pythonпоследний релиз: v0.9.0

Открыть на GitHub ↗

Что это за инструмент

MCP-сервер для безопасного взаимодействия AI-ассистентов с ERP-системой Odoo через стандартизированные ресурсы и инструменты.

Зачем нужен

Позволяет LLM (например, Claude) получать доступ к бизнес-данным, создавать, обновлять и удалять записи в Odoo с помощью естественного языка. Полезен для автоматизации рутинных операций с данными и бизнес-процессами без написания кастомного кода.

Что можно реализовать

Поиск и извлечение записей клиентов, продуктов, счетов или других сущностей Odoo.
Создание новых записей с автоматической проверкой полей и прав доступа.
Обновление существующих данных и удаление записей с учетом разрешений модели.
Выполнение бизнес-действий (например, подтверждение заказа или публикация счета) через workflow actions.
Агрегация данных (группировка, суммирование, подсчет) на стороне сервера Odoo.

Ключевые возможности

Поддержка двух режимов: Enterprise (с модулем Odoo MCP для безопасности) и YOLO (для тестирования без установки модуля).
Умная выборка полей и оптимизированный для LLM формат вывода (иерархический текст).
Встроенная пагинация для работы с большими наборами данных.
Поддержка мультиязычности и персонализированного контекста сессии (часовой пояс, компания).
Доступ к бинарным файлам и вложениям (ir.attachment) через URI ресурсов.

👤 Кому подойдёт: Разработчики, внедряющие AI в бизнес-процессы, и специалисты по Odoo, желающие интегрировать LLM-ассистентов в ERP-систему.

Релизы

v0.9.0majorbreaking

🕐 14 дн назад · релиз на GitHub ↗

Добавлена поддержка JSON-2 transport для Odoo 19+, новые инструменты работы с вложениями и массовые операции, строгая валидация входных данных.

Added: Реализован JSON-2 transport для Odoo 19+ с автоматическим fallback на XML-RPC и новой переменной окружения ODOO_RPC_TRANSPORT.
Added: Добавлены инструменты read_attachment, list_record_attachments и upload_attachment для работы с файлами, а также массовые create_records и update_records.
Breaking: Внедрена строгая валидация аргументов: опечатки и неверные типы данных (например, boolean вместо ID) теперь вызывают ошибки, а не игнорируются.
Added: Появилась поддержка per-call context для управления компаниями, языком и часами, а также лимит ODOO_ALLOWED_COMPANIES для мультикомпаний.
Fixed: Обновлена CI-инфраструктура для тестирования версий Odoo 16–20 и исправлен триггер запуска проверок для pull requests.

v0.8.0majorbreaking

🕐 1 мес назад · релиз на GitHub ↗

Релиз v0.8.0: усиленная безопасность для attachment и полей, новые инструменты контекста и поиска, исправления валидации.

Breaking: Удален метод run_http(), привязка теперь строго следует config.host/port.
Added: Добавлен инструмент get_current_context для получения данных о пользователе и компании.
Added: Реализован инструмент get_fields для исследования схемы с кастомными атрибутами.
Added: Внедрена фильтрация чувствительных полей (пароли, токены) и ограничение размера бинарных данных.
Fixed: Исправлена логика умного выбора полей и добавлена валидация переполнения целых чисел.