odoo-mcp

MCP-сервер для Odoo. Он предоставляет LLM-агенту доступ на чтение и запись к контрагентам, заказам на продажу, остаткам на складе и счетам в экземпляре Odoo.

Статус: ранний. Список инструментов ниже — это план. Не всё из этого пока работает.

Зачем

Odoo — это полноценная ERP с широким API, что затрудняет его использование агентом. Его внешний API — это XML-RPC с универсальными вызовами search_read и execute_kw, поэтому агенту пришлось бы знать имена моделей, имена полей и синтаксис доменов. Этот сервер вместо этого предоставляет небольшой набор именованных инструментов, каждый из которых покрывает задачу, которую реально запросил бы человек.

Odoo Community запускается в Docker с демонстрационными данными, так что всё можно попробовать без реальной системы.

Related MCP server: MCP Server for Odoo

Инструменты

Быстрый старт

docker compose up -d odoo db    # Odoo Community with demo data
cp .env.example .env
docker compose up mcp

При первом запуске Odoo требуется около минуты на инициализацию базы данных.

Как это работает

Сервер подключается к Odoo через XML-RPC. Каждый инструмент сам формирует домен и список полей, поэтому агент никогда не видит внутренности Odoo. Результаты обрезаются до значимых полей и возвращаются в виде плоских записей.

Архитектурные решения

Именованные инструменты, а не универсальный инструмент запросов. Один инструмент run_query было бы проще написать, но гораздо хуже использовать. Именованные инструменты несут собственную валидацию и делают очевидным, что агенту разрешено делать.

Чтение и запись разделены. Инструменты записи помечены в схеме, чтобы клиент мог требовать подтверждения.

Ошибки переводятся. Odoo вызывает сбои с длинными трассировками. Сервер извлекает сообщение и возвращает его в форме, на которую агент может реагировать.

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

• пагинация и ограничения результатов

• поддержка нескольких компаний

• тесты против заполненного экземпляра Odoo

Лицензия

MIT