Odoo Accounting MCP Server

🧾 Odoo Accounting MCP Server

Este es un servidor de Model Context Protocol (MCP) simplificado y no listo para producción, diseñado para la integración experimental con Odoo Accounting mediante XML-RPC. Específicamente adaptado para su uso con Claude Desktop, este proyecto se centra en permitir que las herramientas de IA consulten y analicen asientos contables con fines de auditoría. Si bien permite la interacción con los datos contables de Odoo, su alcance actual se limita a este caso de uso específico y no está destinado a entornos de producción. La exploración futura podría considerar expandirse a otros datos contables, como facturas, dependiendo de los resultados del enfoque inicial.

---

🔧 Ejemplo: Claude Detectando la Herramienta MCP

🚀 Características Principales

• Conexión Segura a Odoo: Establece una conexión segura a tu instancia de Odoo utilizando variables de entorno o un archivo de configuración dedicado.
• Herramientas de Datos Contables: Proporciona herramientas especializadas para buscar y recuperar información contable relevante de manera eficiente.
• Listo para Claude AI: Totalmente compatible con el Model Context Protocol, garantizando una integración fluida con Claude Desktop.
• API RESTful (vía FastAPI): Ofrece un servidor FastAPI simple y robusto para exponer endpoints RESTful.
• Configuración Flexible: Configura fácilmente el servidor a través de los ajustes de configuración de Claude Desktop.

---

🛠️ Guía de Configuración

Sigue estos pasos para configurar y ejecutar el Odoo Accounting MCP Server:

1. Clonar el Repositorio

git clone https://github.com/your-username/odoo-accounting-mcp.git
cd odoo-accounting-mcp

2. Configurar Variables de Entorno

Crea un archivo .env en el directorio raíz del proyecto y complétalo con los detalles de conexión de tu Odoo:

ODOO_URL=http://localhost:8069
ODOO_DB=your_db_name
ODOO_USERNAME=your_odoo_user_name
ODOO_PASSWORD=your_odoo_password

3. Configurar el Entorno Virtual

Se recomienda utilizar un entorno virtual para gestionar las dependencias del proyecto:

python -m venv .venv

Actívalo:

.\.venv\Scripts ctivate

4. Instalar Dependencias

Instala los paquetes de Python requeridos desde el archivo requirements.txt:

python -m pip install -r requirements.txt

5. Ejecutar el Servidor

Inicia el servidor MCP utilizando el script principal de Python:

python main.py

El servidor normalmente se iniciará y será accesible en http://localhost:8000.

---

⚙️ Integración con Claude Desktop

No necesitas ejecutar manualmente el servidor MCP cuando uses Claude Desktop. En su lugar, configura Claude Desktop para que gestione el ciclo de vida del servidor.

Actualiza tu archivo claude_desktop_config.json con la siguiente configuración (ajusta las rutas y las credenciales de Odoo según sea necesario):

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "cwd": "D:/jeevan-projects/odoomcp/odoo_account_mcp",
      "args": ["main.py"],
      "env": {
        "ODOO_URL": "http://localhost:8069",
        "ODOO_DB": "your_db",
        "ODOO_USERNAME": "admin",
        "ODOO_PASSWORD": "your_password"
      }
    }
  }
}

Notas Importantes:

• Asegúrate de que la ruta cwd en la configuración apunte al directorio correcto de tu proyecto odoo_account_mcp.
• Reemplaza las credenciales de Odoo de ejemplo con los detalles reales de tu instancia de Odoo.