odoo-mcp
Servidor FastMCP orientado a Docker para integraciones con Odoo 19 JSON-2.
El tiempo de ejecución expone una fábrica de servidores compartida utilizada tanto por transportes stdio como HTTP. Las herramientas específicas de Odoo pueden registrarse en esa fábrica desde odoo_mcp.tools.register_tools(server, config) o un módulo de registro compatible.
Inicio rápido
Copie la plantilla de entorno:
cp .env.example .envEdite
.envcon su endpoint y credenciales de Odoo.Inicie el servidor HTTP:
docker compose up --buildInspeccione la disponibilidad local:
docker compose exec odoo-mcp uv run --no-sync odoo-mcp healthcheck
El endpoint MCP predeterminado es http://localhost:8000/mcp.
Related MCP server: MCP Odoo Bridge Server
Comandos de tiempo de ejecución
Ejecutar sobre stdio para clientes MCP que lanzan el proceso del servidor directamente:
odoo-mcp stdioEjecutar sobre HTTP:
odoo-mcp http --host 0.0.0.0 --port 8000 --path /mcpInspeccionar la configuración saneada sin exponer secretos:
odoo-mcp inspect-configComprobar la disponibilidad del proceso local sin contactar con Odoo:
odoo-mcp healthcheckConfiguración
Variable | Propósito |
| URL base para llamadas JSON-2 de Odoo. Requerido por las herramientas de la API de Odoo. |
| Nombre opcional de la base de datos de Odoo. |
| Nombre de usuario opcional de Odoo. |
| Contraseña opcional de Odoo. Redactada por |
| Clave de API opcional de Odoo. Redactada por |
| Secreto opcional para futuros middleware de autenticación HTTP. Redactado por |
| Host de enlace HTTP. Por defecto |
| Puerto de enlace HTTP. Por defecto |
| Ruta del endpoint HTTP. Por defecto |
| Nivel de registro de Uvicorn. Por defecto |
Desarrollo
Instale y ejecute pruebas con uv:
uv sync
uv run pytestComprobaciones estáticas utilizadas por CI:
uv run ruff check .
uv run mypyDocker es la ruta de despliegue objetivo, pero no se requiere Docker local para las pruebas unitarias. La comprobación de salud de Docker utiliza odoo-mcp healthcheck, que valida la conexión del proceso del servidor sin realizar llamadas de red externas.
Puntos de integración
La fábrica compartida es odoo_mcp.server.build_server(). Siempre registra una herramienta healthcheck local, y luego intenta importar el registro de herramientas desde:
odoo_mcp.tools.register_toolsodoo_mcp.tools.registry.register_toolsodoo_mcp.tools.odoo.register_tools
Las funciones compatibles pueden aceptar (server) o (server, config). Esto tiene como objetivo permitir que el cliente de Odoo, el esquema y los trabajadores de herramientas se implementen de forma independiente sin cambiar los puntos de entrada del tiempo de ejecución.
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
