edubolivar/odoo-mcp-server

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

10 stars 3 forks Качество 68 Тренд 18

An enterprise-grade server for interacting with Odoo ERP through AI assistants. Unlike a traditional database connector, this server is designed as an : it teaches the AI how to navigate Odoo,...

Обзор

An enterprise-grade server for interacting with Odoo ERP through AI assistants. Unlike a traditional database connector, this server is designed as an : it teaches the AI how to navigate Odoo, understand its business logic, and perform complex data analysis. - — Native instructions that teach your AI how to audit inventory, analyse sales, or review security permissions step by step, without writing prompts from scratch. - — Optimised support for read_group and advanced analytical operations, allowing the AI to generate financial reports or KPIs instantly. - — Tools that grant the AI X-ray vision: discover available action buttons, inspect view XML architectures, evaluate security rules — reducing hallucinations to a minimum. - — Uses only Python stdlib (urllib, json, csv, xml) plus the mcp package. No requests, no odoorpc. - — Uses Odoo's own XML-RPC layer; the MCP server cannot bypass permissions the user doesn't already have. Always prefer an over a plain password.

README

Показан фрагмент оригинального README. Открыть оригинал.

Odoo MCP Server — Agentic Edition

An enterprise-grade Model Context Protocol (MCP) server for interacting with Odoo ERP through AI assistants. Unlike a traditional database connector, this server is designed as an agentic bridge: it teaches the AI how to navigate Odoo, understand its business logic, and perform complex data analysis.

Why Agentic Edition?

Guided Workflows (Prompts) — Native instructions that teach your AI how to audit inventory, analyse sales, or review security permissions step by step, without writing prompts from scratch.
Native BI — Optimised support for read_group and advanced analytical operations, allowing the AI to generate financial reports or KPIs instantly.
Deep Introspection — Tools that grant the AI X-ray vision: discover available action buttons, inspect view XML architectures, evaluate security rules — reducing hallucinations to a minimum.
Zero extra dependencies — Uses only Python stdlib (urllib, json, csv, xml) plus the mcp package. No requests, no odoorpc.
Built-in Security — Uses Odoo’s own XML-RPC layer; the MCP server cannot bypass permissions the user doesn’t already have.

Installation

# Recommended — isolated and fast
uv tool install odoo-mcp-server-conn

# Standard
pip install odoo-mcp-server-conn

Configuration

Environment variables

Variable	Required	Description
`ODOO_URL`	✅	Your Odoo URL (e.g. `http://localhost:8069`)
`ODOO_DB`	✅	Database name
`ODOO_USERNAME`	✅	User login or email
`ODOO_PASSWORD`	✅	Password or API Key (strongly recommended)
`MCP_AUTH_CACHE_TTL`	❌	Seconds before re-authenticating (default: `300`)

Tip: Always prefer an API Key over a plain password. Generate one in Odoo under Settings → Users → Your User → API Keys.

Claude Code (CLI)

Run this command once — it stores the configuration permanently for the current project:

claude mcp add odoo-server \
  --env ODOO_URL=http://localhost:8069 \
  --env ODOO_DB=my_database \
  --env ODOO_USERNAME=admin \
  --env ODOO_PASSWORD=my_api_key \
  -- odoo-mcp-server-conn

Verify the connection inside Claude Code:

/mcp

Add --scope project to create a .mcp.json at the repository root that your whole team can use. Each developer supplies their own credentials via environment variables or CI secrets.

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "odoo-server": {
      "command": "odoo-mcp-server-conn",
      "env": {
        "ODOO_URL": "http://localhost:8069",
        "ODOO_DB": "my_database",
        "ODOO_USERNAME": "admin",
        "ODOO_PASSWORD": "my_api_key"
      }
    }
  }
}