odoo-mcp
FastMCP-сервер с приоритетом Docker для интеграций с Odoo 19 через JSON-2.
Среда выполнения предоставляет общую фабрику серверов, используемую как для транспорта stdio, так и для HTTP.
Инструменты, специфичные для Odoo, могут быть зарегистрированы в этой фабрике через odoo_mcp.tools.register_tools(server, config) или совместимый модуль реестра.
Быстрый старт
Скопируйте шаблон окружения:
cp .env.example .envОтредактируйте
.env, указав адрес вашего Odoo и учетные данные.Запустите HTTP-сервер:
docker compose up --buildПроверьте локальную готовность:
docker compose exec odoo-mcp uv run --no-sync odoo-mcp healthcheck
Конечная точка MCP по умолчанию: http://localhost:8000/mcp.
Related MCP server: MCP Odoo Bridge Server
Команды среды выполнения
Запуск через stdio для MCP-клиентов, которые запускают процесс сервера напрямую:
odoo-mcp stdioЗапуск через HTTP:
odoo-mcp http --host 0.0.0.0 --port 8000 --path /mcpПросмотр очищенной конфигурации без раскрытия секретов:
odoo-mcp inspect-configПроверка готовности локального процесса без обращения к Odoo:
odoo-mcp healthcheckКонфигурация
Переменная | Назначение |
| Базовый URL для вызовов Odoo JSON-2. Требуется для инструментов API Odoo. |
| Необязательное имя базы данных Odoo. |
| Необязательное имя пользователя Odoo. |
| Необязательный пароль Odoo. Скрывается командой |
| Необязательный API-ключ Odoo. Скрывается командой |
| Необязательный секрет для будущего промежуточного ПО HTTP-аутентификации. Скрывается командой |
| Хост для привязки HTTP. По умолчанию |
| Порт для привязки HTTP. По умолчанию |
| Путь к конечной точке HTTP. По умолчанию |
| Уровень логирования Uvicorn. По умолчанию |
Разработка
Установка и запуск тестов с помощью uv:
uv sync
uv run pytestСтатические проверки, используемые в CI:
uv run ruff check .
uv run mypyDocker является целевым путем развертывания, но локальный Docker не требуется для модульных тестов. Проверка работоспособности (healthcheck) Docker использует odoo-mcp healthcheck, которая проверяет подключение процесса сервера без выполнения внешних сетевых вызовов.
Точки интеграции
Общая фабрика — odoo_mcp.server.build_server(). Она всегда регистрирует локальный инструмент healthcheck, а затем пытается импортировать регистрацию инструментов из:
odoo_mcp.tools.register_toolsodoo_mcp.tools.registry.register_toolsodoo_mcp.tools.odoo.register_tools
Совместимые функции могут принимать аргументы (server) или (server, config). Это сделано для того, чтобы клиент Odoo, схема и рабочие инструменты могли добавляться независимо без изменения точек входа среды выполнения.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Tools
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/plgonzalezrx8/odoo-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
