Odoo Forge

Odoo锻造

面向Odoo 18的AI首个ERP配置引擎

   

CLI工具包+ MCP服务器 这给了人工智能助手 完全控制 奥多18。

79个工具。6技能。4名专业代理。领域知识。规划。代码生成。

入门指南 · 工具参考 · 建筑 · 贡献

______________________________________________________________________

它能做什么？

"I run a bakery with 3 locations and delivery — set up my Odoo"

"Show me how sales are doing this month compared to last month"

"Import my product catalog from this CSV file"

"Add a custom loyalty tier field to contacts as a selection"

"Generate a custom addon for recipe management with ingredient tracking"

"Something broke after that module install — help me fix it"

"Create an automation that sends a welcome email for new contacts"

"Run the restaurant recipe to set up a full POS system"

Odoo Forge将自然语言转化为Odoo操作。这不是一个一次性的设置工具，而是一个 正在进行的AI层 它可以帮助您发现、构建、填充、分析、修复和改进您的Odoo实例。

快速开始

1.安装

pip install odooforge

2.初始化工作区

mkdir my-odoo-project && cd my-odoo-project
odooforge init

这为您提供了所需的一切：

.
├── CLAUDE.md                     # AI assistant context
├── .env                          # Connection settings (fill in your details)
├── .claude/
│   ├── skills/                   # 6 Claude Code skills
│   │   ├── odoo-brainstorm/      #   /odoo-brainstorm — explore ideas
│   │   ├── odoo-architect/       #   /odoo-architect — design models
│   │   ├── odoo-debug/           #   /odoo-debug — fix issues
│   │   ├── odoo-setup/           #   /odoo-setup — deploy business
│   │   ├── odoo-data/            #   /odoo-data — import & manage data
│   │   └── odoo-report/          #   /odoo-report — dashboards & analytics
│   └── agents/                   # 4 specialist subagents
│       ├── odoo-explorer.md      #   Read-only instance scout
│       ├── odoo-executor.md      #   Plan execution engine
│       ├── odoo-reviewer.md      #   Post-execution validator
│       └── odoo-analyst.md       #   Business data analyst
├── docker/
│   ├── docker-compose.yml        # Odoo 18 + PostgreSQL 17
│   └── odoo.conf
├── addons/                       # Your custom Odoo modules
├── .cursor/mcp.json              # Cursor MCP config
├── .windsurf/mcp.json            # Windsurf MCP config
└── .gitignore

3.启动Odoo

# Edit .env with your connection details, then:
cd docker && docker compose up -d

4.开始编码

在AI编辑器中打开工作区。MCP配置已经设置好了——您的助手可以访问所有79个Odoo Forge工具。

让你的AI助手运行 odoo_diagnostics_health_check 以验证所有内容是否已连接。

更新您的工作区

升级Odoo Forge后(pip install --upgrade odooforge)，将工作区模板文件更新为最新版本：

odooforge init --update

这会用最新版本覆盖技能、代理、配置和Docker文件。你的 .env 是 从不 覆盖。

Odoo Forge生命周期

Odoo Forge不仅适用于初始设置，它还会随着您的业务发展而与您同在：

Discover → Plan → Build → Populate → Analyze → Fix → Evolve
   ↑                                                    │
   └────────────────────────────────────────────────────┘

20个类别中的79个工具

完整工具参考→

领域知识与人工智能指导

Odoo Forge内置了领域知识，可帮助AI助手做出明智的决策：

MCP资源（6）

结构化知识可通过以下方式访问 odoo:// URI：

MCP提示（4）

提供分步说明的指导性工作流程：

克劳德代码技能（6）

为Claude Code用户提供大量命令技能（安装到 .claude/skills/ 通过 odooforge init):

专业代理（4）

Claude为集中任务派遣的子代理（安装到 .claude/agents/ 通过 odooforge init):

代理具有受限的工具访问权限（最小特权原则）。只读代理不能写；执行器总是在更改之前进行快照。

行业食谱

常见业务类型的一个命令设置：

"Run the restaurant recipe in dry-run mode first, then execute it"

配置

Odoo Forge可以通过环境变量进行配置。当作为MCP服务器运行时，请将这些传递到您的 mcp.json 或 claude_desktop_config.json.

MCP客户端配置(mcp.json)

选项1：使用 uvx （推荐）

这将运行与您的系统隔离的最新发布版本的Odoo Forge。

{
  "mcpServers": {
    "odooforge": {
      "command": "uvx",
      "args": ["odooforge"],
      "env": {
        "ODOO_URL": "http://localhost:8069",
        "ODOO_DEFAULT_DB": "odoo",
        "ODOO_ADMIN_USER": "admin",
        "ODOO_ADMIN_PASSWORD": "my_admin_password",
        "ODOO_MASTER_PASSWORD": "my_master_password",
        "POSTGRES_HOST": "localhost",
        "POSTGRES_PORT": "5432",
        "POSTGRES_USER": "odoo",
        "POSTGRES_PASSWORD": "my_postgres_password"
      }
    }
  }
}

方案2：利用当地项目（开发）

如果您在本地虚拟环境中自定义了Odoo Forge：

{
  "mcpServers": {
    "odooforge": {
      "command": "/path/to/your/venv/bin/odooforge",
      "args": [],
      "env": {
        "ODOO_ADMIN_PASSWORD": "secure_password"
      }
    }
  }
}

建筑

graph TB
    AI[AI Assistant
Claude / Cursor / etc.] -->|MCP Protocol| MCP[OdooForge MCP Server
79 tools · 6 resources · 4 prompts]

    AI -->|Skills & Agents| CC[Claude Code Integration
6 skills · 4 agents]

    MCP --> Planning[Planning Layer]
    MCP --> Workflows[Workflow Layer]
    MCP --> Tools[Core Tool Layer]
    MCP --> Knowledge[Knowledge Layer]

    subgraph CC[Claude Code]
        direction LR
        Skills[6 Skills
brainstorm · architect · setup
data · report · debug]
        Agents[4 Agents
explorer · executor
reviewer · analyst]
    end

    subgraph Planning[Layer 3: Planning]
        direction LR
        P1[Requirement Analysis]
        P2[Solution Design]
        P3[Plan Validation]
    end

    subgraph Workflows[Layer 2: Workflows]
        direction LR
        W1[Business Setup]
        W2[Feature Builder]
        W3[Dashboard]
        W4[Integration]
    end

    subgraph Tools[Layer 0: Core Tools]
        direction LR
        T1[Records]
        T2[Modules]
        T3[Schema]
        T4[Views]
        T5[+ 13 more]
    end

    subgraph Knowledge[Layer 1: Domain Knowledge]
        direction LR
        K1[Module KB]
        K2[Blueprints]
        K3[Patterns]
    end

    subgraph Codegen[Code Generation]
        direction LR
        C1[Model Gen]
        C2[View Gen]
        C3[Security Gen]
    end

    Workflows --> Codegen
    Tools --> Conn[Connections]

    subgraph Conn[Connections]
        direction LR
        RPC[XML-RPC]
        Docker[Docker]
        PG[PostgreSQL]
    end

    Conn --> Odoo[Odoo 18
Docker Container]
    Conn --> DB[(PostgreSQL 17
Docker Container)]

    style AI fill:#5A67D8,color:#fff
    style MCP fill:#714B67,color:#fff
    style Odoo fill:#714B67,color:#fff
    style DB fill:#336791,color:#fff

src/odooforge/
├── cli.py                    # CLI — server, init, init --update
├── init.py                   # Workspace initializer — skills, agents, configs, Docker
├── server.py                 # MCP server — 79 tools, 6 resources, 4 prompts
├── config.py                 # Environment configuration
├── data/                     # Bundled templates for odooforge init
│   ├── skills/               # 6 skill definitions (SKILL.md)
│   ├── agents/               # 4 agent definitions (.md)
│   └── ...                   # .env.example, docker, mcp configs
├── connections/
│   ├── docker_client.py      # Docker Compose management
│   ├── xmlrpc_client.py      # Odoo XML-RPC interface
│   └── pg_client.py          # PostgreSQL direct connection
├── tools/                    # One file per tool category (20 files)
├── knowledge/                # Domain knowledge (Layer 1)
├── planning/                 # Planning engine (Layer 3)
├── workflows/                # Workflow orchestration (Layer 2)
├── codegen/                  # Code generation engine
├── utils/                    # Shared utilities
└── verification/             # Post-operation verification

安全特性

Odoo Forge旨在为AI驱动的操作提供安全保障：

• 快照 --在危险操作之前创建备份。立即恢复。这 odoo-executor 代理会自动执行此操作。
• 确认警卫 --破坏性操作（删除、删除、卸载）需要 confirm=true.
• 命名空间强制 --自定义字段必须以开头 x_，定制型号 x_没有意外的堆芯修改。
• 术后验证 --模块安装、字段创建和视图修改在执行后进行验证。
• 干运行模式 --执行前可以预览食谱和进口。
• 输入验证 --模型名称、字段名称、SQL查询和域在执行前会经过验证。
• 代理隔离 --只读代理（资源管理器、审阅者、分析师）无法修改您的实例。执行器代理具有受限的工具访问权限。

发展

# Clone and install
git clone https://github.com/hamzatrq/odoo-forge.git
cd odooforge
uv sync --group dev

# Run tests (567 tests)
uv run pytest tests/ -v

# Run the server locally
uv run odooforge

看 贡献.md 详细的开发指南。

文档

许可证

AGPL-3.0