MCP-Odoo

# MCP-Odoo Model Context Protocol server for Odoo integration, allowing AI agents to access and manipulate Odoo data through a standardized interface. ## Overview MCP-Odoo provides a bridge between Odoo ERP systems and AI agents using the Model Context Protocol (MCP). This enables AI systems to: - Access partner information - View and analyze accounting data including invoices and payments - Perform reconciliation of financial records - Query vendor bills and customer invoices ## Features - 🔌 Easy integration with Odoo instances - 🤖 Standard MCP interface for AI agent compatibility - 📊 Rich accounting data access - 🔒 Secure authentication with Odoo ## Installation ```bash # 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 ``` ## Configuration Create a `.env` file in the project root with the following 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 ``` ## Usage Start the MCP server: ```bash # Using the SSE transport (default) python -m mcp_odoo_public # Using stdio for local agent integration python -m mcp_odoo_public --transport stdio ``` ## Documentation Comprehensive documentation is available in the `docs/` directory: - [Documentation Home](docs/index.md) - Start here for an overview of all documentation - [Implementation Guide](docs/implementation_guide.md) - Detailed architecture and implementation details - [Accounting Functionality](docs/accounting_guide.md) - In-depth guide to accounting features - [Troubleshooting](docs/troubleshooting.md) - Solutions for common issues - [Usage Examples](docs/examples/basic_usage.md) - Practical examples to get started ## Development ### Project Structure - `mcp_odoo_public/`: Main package - `odoo/`: Odoo client and related modules - `resources/`: MCP resources definitions (tools and schemas) - `server.py`: MCP server implementation - `config.py`: Configuration management - `mcp_instance.py`: FastMCP instance definition ### Adding New Resources Resources define the capabilities exposed to AI agents through MCP. To add a new resource: 1. Create a new file in the `resources/` directory 2. Define your resource using the `@mcp.tool()` decorator 3. Import your resource in `resources/__init__.py` For detailed instructions, see the [Implementation Guide](docs/implementation_guide.md). ## License This project is licensed under the MIT License - see the LICENSE file for details. ## Author Albert Gil López - Email: albert.gil@yourtechtribe.com - LinkedIn: https://www.linkedin.com/in/albertgilopez/ ## Contributing Contributions are welcome! Please feel free to submit a Pull Request.