Python Odoo MCP Server v0.1.0

Overview

First stable release of Python Odoo MCP Server - a production-ready HTTP REST API for Odoo automation with enterprise-grade features.

Major Features

✅ Comprehensive Test Suite - 142 unit and integration tests with 75.37% code coverage
✅ Multi-tenant Support - Multiple users and Odoo instances on a single server
✅ Scope-based Access Control - Fine-grained R/W/D permissions per Odoo model
✅ Encrypted API Keys - Fernet encryption for secure credential storage
✅ Connection Pooling - Scope-aware connection caching with TTL expiration
✅ n8n Integration - Ready for n8n automation workflows via HTTP
✅ Complete CRUD - Search, read, create, write, delete any Odoo model
✅ Async/Await - Full async support for high concurrency
✅ Docker Ready - Docker Compose configuration for easy deployment

What's New

Testing & Quality

• 142 comprehensive unit and integration tests across 8 test modules
• 75.37% code coverage (exceeds 75% target)
• Mocked tests for all critical paths without requiring live Odoo instance
• Full error path testing (auth failures, XML-RPC faults, network errors)
• Coverage enforcement in CI/CD pipeline

Documentation

• Restructured README with feature-first approach
• Added comprehensive CONTRIBUTING.md for developers
• Clear testing and development guidelines
• REST API vs MCP Protocol distinction explained
• Complete n8n integration examples

Repository

• Added MIT License for legal clarity
• Removed test artifacts (test_n8n.json)
• GitHub Actions CI/CD with automated testing
• Codecov integration for continuous coverage tracking

Test Coverage by Module

Module	Coverage	Tests
connection/pool.py	100%	23
connection/manager.py	100%	12
auth/header_parser.py	100%	27
config.py	100%	10
encryption.py	100%	13
odoo/client.py	80%	15
tools/tools.py	75%	19
Overall	75.37%	142

Getting Started

```bash

Clone

git clone https://github.com/christopher-igweze/python-odoo-mcp.git
cd python-odoo-mcp

Install

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Run

python -m src.server

Or with Docker

docker-compose up --build
```

Resources

• Documentation: See README.md for features and usage
• Development: See CONTRIBUTING.md for development setup and testing
• Issues: https://github.com/christopher-igweze/python-odoo-mcp/issues
• Discussions: https://github.com/christopher-igweze/python-odoo-mcp/discussions

Known Limitations

• Requires Odoo 11.0+ (XML-RPC API)
• Connection pooling TTL defaults to 60 minutes
• No built-in request rate limiting (deploy behind nginx/reverse proxy for that)

Credits

Built with ❤️ using FastAPI, cryptography, and pytest.