edubolivar/odoo-mcp-server

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

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.

GitHub で README 全文を見る

インストール

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"
      }
    }
  }
}