模型上下文协议（MCP）服务器，使AI助手能够通过标准化资源和工具安全地与Odoo的ERP系统交互，进行数据检索和操作。
概览
一个MCP服务器，使像Claude这样的AI助手能够与Odoo的ERP系统交互。访问业务数据、搜索记录、创建新条目、更新现有数据，并通过自然语言管理你的Odoo实例。 使用YOLO模式进行快速测试和任何标准Odoo安装演示。企业安全、访问控制和生产使用时，安装Odoo MCP模块。 - 🔍 任何 Odoo 记录（客户、产品、发票等）——✨带有字段验证和权限检查——✏️智能字段处理——🗑️尊重模型级权限——🔢匹配特定条件——📋理解数据结构——📊——分组、求和和计数，无需拉取原始行——⚡——调用任何公开的 Odoo 方法（发票后、确认订单等）。
概述（AI 翻译）
一个MCP服务器，使像Claude这样的AI助手能够与Odoo的ERP系统交互。访问业务数据、搜索记录、创建新条目、更新现有数据，并通过自然语言管理你的Odoo实例。
**支持任何Odoo实例！**使用YOLO模式进行快速测试和演示，使用任何标准Odoo安装。企业安全、访问控制和生产使用时，安装Odoo MCP模块。
特色
- 🔍 搜索和检索任何Odoo记录（客户、产品、发票等）
- ✨ 创建新记录，并进行字段验证和权限检查
- ✏️ 用智能字段处理更新现有数据
- 🗑️ 删除记录 尊重模型级权限
- 🔢 计数符合特定标准的记录
- 📋 检查模型字段以理解数据结构
- 📊 服务器端聚合 — 分组、求和和计数，无需拉取原始行
- ⚡ 工作流程动作 — 通过选择加入的逃逸出口调用公共业务方法（发票后、确认订单记录等）
- 📎 二进制和附件资源 — 通过资源URI获取图片、文档和
ir.attachment文件
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
MCP Server for Odoo
An MCP server that enables AI assistants like Claude to interact with Odoo ERP systems. Access business data, search records, create new entries, update existing data, and manage your Odoo instance through natural language.
Works with any Odoo instance! Use YOLO mode for quick testing and demos with any standard Odoo installation. For enterprise security, access controls, and production use, install the Odoo MCP module.
Features
- 🔍 Search and retrieve any Odoo record (customers, products, invoices, etc.)
- ✨ Create new records with field validation and permission checks
- ✏️ Update existing data with smart field handling
- 🗑️ Delete records respecting model-level permissions
- 🔢 Count records matching specific criteria
- 📋 Inspect model fields to understand data structure
- 📊 Server-side aggregation — group, sum, and count without pulling raw rows
- ⚡ Workflow actions — invoke public business methods (post invoice, confirm SO, etc.) via an opt-in escape hatch
- 📎 Binary & attachment resources — fetch images, documents, and
ir.attachmentfiles via resource URIs - 👤 Personalized session context — the connected user, timezone, and company scope injected into the session instructions
- 🔐 Secure access with API key or username/password authentication
- 🎯 Smart pagination for large datasets
- 🧠 Smart field selection — automatically picks the most relevant fields per model
- 💬 LLM-optimized output with hierarchical text formatting
- 🌍 Multi-language support — get responses in your preferred language
- 🚀 YOLO Mode for quick access with any Odoo instance (no module required)
Installation
Prerequisites
- Python 3.10 or higher
- Access to an Odoo instance:
- Standard mode (production): Version 16.0+ with the Odoo MCP module installed
- YOLO mode (testing/demos): Any Odoo version with XML-RPC enabled (no module required)
Install UV First
安装
uvx mcp-server-odoo配置
{
"mcpServers": {
"odoo": {
"command": "uvx",
"args": ["mcp-server-odoo"],
"env": {
"ODOO_URL": "https://your-odoo-instance.com",
"ODOO_API_KEY": "your-api-key-here"
}
}
}
}