传统的Odoo AI集成通常依赖于独立的Python进程,通过XML-RPC或JSON-RPC从外部与Odoo通信。这种方式虽然可行,但也带来了凭证管理、额外部署以及AI操作缺乏内置可见性等问题。
为了解决这些痛点,一个名为 muk_mcp 的开源插件应运而生,它将Odoo本身转化为一个原生MCP(Model-Controller-Presenter)服务器。这意味着不再需要额外的进程、中间件或RPC桥接,/mcp 端点直接嵌入到Odoo注册表中,并与所有其他功能一样,通过Odoo的ORM(对象关系映射)层运行。
安装muk_mcp后,用户只需从偏好设置中生成一个MCP密钥,并将其URL粘贴到支持MCP的AI客户端中,例如Claude Code、Claude Desktop、Cursor、Windsurf、Codex CLI或OpenCode。AI模型将获得15种类型化的工具,覆盖完整的ORM生命周期,包括模型发现、模式内省、搜索、读取、创建、更新、删除、分组聚合、聊天记录(chatter)以及方法执行。
主要特性与优势:
- 精细化权限与速率限制: 每个密钥都支持模型级别的作用域,可配置独立的读/写/创建/删除权限。此外,每个密钥还可设置可配置的速率限制(默认每分钟60次请求)。
- 全面审计日志: 每一次AI调用都会记录在审计日志中,包含方法、工具、模型、持续时间和状态,确保AI操作的可追溯性。
- UI内自定义AI工具: 用户可以直接从Odoo后台UI添加自定义工具,只需提供名称、描述、输入参数的JSON Schema以及在沙盒安全评估(safe_eval)环境中运行的Python代码。无需代码部署或服务器重启,连接的客户端会在工具列表发生变化时收到通知。
- 会话管理: 会话根据MCP规范保持状态,并在配置的超时后自动清理。用户也可以从偏好设置中撤销自己的会话。
- AI标记的聊天记录: 任何由MCP工具生成的聊天记录消息都会在作者姓名旁附带一个小的MCP徽章,使得用户能够立即区分哪些评论、状态更改和跟踪条目来自AI客户端,哪些来自人工操作,增强了透明度。
muk_mcp的出现,为企业利用AI Agent直接驱动Odoo提供了更高效、安全且透明的集成方案,极大地简化了Odoo与AI模型的交互过程,推动了企业管理系统的智能化升级。