基本能力
产品定位
mcp-odoo 是一个与 Odoo ERP 系统集成的 MCP 服务器，旨在通过 Model Context Protocol 实现 AI 助手与 Odoo 数据和功能的无缝交互。
核心功能
- 全面的 Odoo 集成：支持访问 Odoo 模型、记录和方法
- XML-RPC 通信：通过 XML-RPC 安全连接到 Odoo 实例
- 灵活的配置：支持配置文件和环境变量
- 资源模式系统：基于 URI 的 Odoo 数据结构访问
- 错误处理：提供清晰的错误消息
- 无状态操作：可靠的请求/响应循环
适用场景
- 企业资源规划（ERP）系统集成
- 自动化业务流程
- 数据查询和管理
- 自定义业务逻辑执行
工具列表
- search_records：搜索 Odoo 模型中的记录
- read_record：读取特定记录的详细信息
- create_record：在 Odoo 中创建新记录
- update_record：更新现有记录
- delete_record：从 Odoo 中删除记录
- execute_method：在 Odoo 模型上执行自定义方法
- get_model_fields：获取模型的字段定义
- search_employee：按名称搜索员工
- search_holidays：搜索指定日期范围内的假期
常见问题解答
- 如何配置 Odoo 连接？
- 通过配置文件
odoo_config.json或环境变量设置连接参数 - 如何运行服务器？
- 使用
odoo-mcp命令或 MCP 开发工具 - 如何格式化搜索条件？
- 支持列表格式和对象格式的域参数
使用教程
使用依赖
- Python 环境
- Odoo 实例访问权限
安装教程
bash
pip install odoo-mcp
运行服务器
```bash
使用安装的包
odoo-mcp
使用 MCP 开发工具
mcp dev odoo_mcp/server.py
带额外依赖
mcp dev odoo_mcp/server.py --with pandas --with numpy
挂载本地代码进行开发
mcp dev odoo_mcp/server.py --with-editable .
```
Docker 构建
bash
docker build -t mcp/odoo:latest -f Dockerfile .
调试方式
- 检查 Odoo 连接配置是否正确
- 验证环境变量是否设置
- 使用详细的日志输出进行调试
- 测试基本的搜索和读取操作
示例调试命令：
bash
odoo-mcp --verbose
