MCP-Odoo

Servidor de protocolo de contexto de modelo para la integración de Odoo, que permite a los agentes de IA acceder y manipular datos de Odoo a través de una interfaz estandarizada.

Descripción general

MCP-Odoo proporciona un puente entre los sistemas ERP de Odoo y los agentes de IA mediante el Protocolo de Contexto de Modelo (MCP). Esto permite a los sistemas de IA:

• Acceder a la información del socio

• Ver y analizar datos contables, incluidas facturas y pagos.

• Realizar la conciliación de registros financieros

• Consultar facturas de proveedores y facturas de clientes

Related MCP server: Odoo MCP Improved

Características

• 🔌 Fácil integración con instancias de Odoo

• 🤖 Interfaz MCP estándar para compatibilidad con agentes de IA

• 📊 Acceso a datos contables enriquecidos

• 🔒 Autenticación segura con Odoo

Instalación

# Clone the repository
git clone https://github.com/yourtechtribe/model-context-protocol-mcp-odoo.git
cd model-context-protocol-mcp-odoo

# Install dependencies
pip install -r requirements.txt

Configuración

Cree un archivo .env en la raíz del proyecto con las siguientes variables:

ODOO_URL=https://your-odoo-instance.com
ODOO_DB=your_database
ODOO_USERNAME=your_username
ODOO_PASSWORD=your_password
HOST=0.0.0.0
PORT=8080

Uso

Inicie el servidor MCP:

# Using the SSE transport (default)
python -m mcp_odoo_public

# Using stdio for local agent integration
python -m mcp_odoo_public --transport stdio

Documentación

La documentación completa está disponible en el directorio docs/ :

• Documentación Inicio - Comience aquí para obtener una descripción general de toda la documentación

• Guía de implementación : Arquitectura detallada y detalles de implementación

• Funcionalidad contable : guía detallada sobre las funciones contables

• Solución de problemas : soluciones para problemas comunes

• Ejemplos de uso : ejemplos prácticos para empezar

Desarrollo

Estructura del proyecto

• mcp_odoo_public/ : Paquete principal

  • odoo/ : Cliente Odoo y módulos relacionados

  • resources/ : Definiciones de recursos de MCP (herramientas y esquemas)

  • server.py : implementación del servidor MCP

  • config.py : Gestión de configuración

  • mcp_instance.py : definición de instancia de FastMCP

Agregar nuevos recursos

Los recursos definen las capacidades expuestas a los agentes de IA a través de MCP. Para agregar un nuevo recurso:

1. Crea un nuevo archivo en el directorio resources/

2. Define tu recurso usando el decorador @mcp.tool()

3. Importa tu recurso en resources/__init__.py

Para obtener instrucciones detalladas, consulte la Guía de implementación .

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Autor

Albert Gil López

• Correo electrónico: albert.gil@yourtechtribe.com

• LinkedIn: https://www.linkedin.com/in/albertgilopez/

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.