Skip to content

v1.11.0 — Safety Layer, DX Improvements & MCP 2025-11-25

Latest
Latest

Choose a tag to compare

View all tags
@AlanOgic AlanOgic released this 13 Feb 08:29
· 101 commits to master since this release
v1.11.0
3524944

What's New

This release brings major improvements across safety, developer experience, and protocol compliance. Five releases worth of features since v1.6.0:

Safety Layer (v1.10.0)

Pre-execution safety classification that gates dangerous operations behind confirmation.

  • 4 risk levels: SAFE → MEDIUM → HIGH → BLOCKED
  • Blocked models: ir.rule, ir.model.access, ir.module.module, ir.config_parameter, res.users — write operations always refused
  • Sensitive models: account.move, account.payment, account.bank.statement, hr.payslip, ir.cron — write operations always require confirmation
  • Cascade warnings: Side effects surfaced for action_confirm, action_post, button_validate, etc.
  • Confirmation flow: Operations return pending_confirmation=true with safety classification; re-call with confirmed=true to proceed
  • Configurable: MCP_SAFETY_MODE (strict/permissive), MCP_SAFETY_AUDIT for audit logging

DX Improvements (v1.11.0)

Token-efficient resources and smart resolution for AI agents:

  • Quick Schema (odoo://model/{model}/quick-schema): Ultra-compact schema with short keys (t, req, ro, rel). ~60-80% smaller than /fields
  • Bundle (odoo://bundle/{models}): Batch quick-schema for up to 10 models in one call
  • Session Bootstrap (odoo://session-bootstrap): One call to bootstrap a conversation with schemas + workflows for common models
  • Workflow (odoo://model/{model}/workflow): State machine transitions for 6 main models with side effects and irreversibility flags. Dynamic fallback for unmapped models
  • Many2one Resolution (resolve_json parameter): Auto-resolve field names to IDs via name_search. No need to know numeric IDs
  • Default Context (MCP_DEFAULT_CONTEXT): JSON object merged into all operation contexts (e.g., {"lang": "fr_FR"})
  • Expanded Error Patterns: ~25 patterns (up from ~5) with {model} template substitution
  • Bug Fix: Context now correctly preserved when search_read falls back to search + read

MCP 2025-11-25 Specification (v1.9.0)

  • Background Tasks (SEP-1686): batch_execute and execute_workflow support async execution with progress tracking
  • Icons (SEP-973): Server and tools display Odoo brand icon in compatible MCP clients
  • Structured Output Schemas: All tools return typed Pydantic response models with execution time
  • User Elicitation: Interactive configure_odoo tool for connection setup

HTTP Transport (v1.8.0)

  • Streamable HTTP transport with Bearer token authentication
  • MCP_TRANSPORT=streamable-http to switch from STDIO
  • MCP_API_KEY for secure remote access

Automatic Fallback System (v1.7.0)

  • search_read → search + read fallback on 500 errors
  • Error categorization (timeout, relational_filter, computed_field, access_rights, memory)
  • Runtime issue tracking and pattern detection
  • odoo://model-limitations resource

Other Improvements

  • read_resource tool for Claude Desktop compatibility (clients without MCP resources support)
  • Live-enriched odoo://methods/{model} via /doc-bearer/ endpoint (signatures, return types, API decorators)
  • Lightweight odoo://model/{model}/fields resource
  • Complete documentation rewrite with step-by-step install guide

Stats

  • 5 tools | 27 resources | 13 prompts
  • 30 ORM methods documented
  • 13 Odoo modules with special methods
  • ~25 error patterns with actionable suggestions

Breaking Changes

None. All new features are backward-compatible.

Installation

# Docker (recommended)
docker pull alanogik/odoo-mcp-19:latest

# Or from source
git clone https://github.com/AlanOgic/odoo-mcp-19.git
cd odoo-mcp-19
python3 -m venv .venv && source .venv/bin/activate
pip install -e .

See README for full setup guide including Claude Desktop configuration.

Assets 2
Loading