SuperAPI AI 工具集

odoo-claude-mcp

odoo-claude-mcp 是一套自托管的 MCP 服务器套件,用于将 Claude 连接至自托管 Odoo ERP(支持 15 至 19 版本),提供 197+ 工具、多租户支持和保加利亚本地化(НАП、ДДС、ЕИК)。它通过统一认证网关连接 Odoo、GitHub、文件系统、Portainer、Teams 等,并附带浏览器终端(xterm.js + tmux + Claude Code)、Qdrant 向量记忆与 Ollama 本地 LLM 集成。当前分支 3.0 为预览轨道(v3.3.8),稳定轨道为分支 2.0(v2.31.0)。支持 Docker Compose、K3s/Kubernetes 和 Claude.ai 连接器部署。

访问官网

工具介绍

odoo-claude-mcp 是一套面向 Odoo ERP 的生产级 Model Context Protocol(MCP)服务器套件,用于将 Claude 及任何兼容 MCP 的客户端连接至自托管 Odoo 实例(15 至 19 版本),并整合 Odoo 开发、运维及团队协作所需的辅助服务。

用途

将自托管 Odoo 实例变为 Claude 生态中的一等成员,面向 Odoo 开发者、顾问、业务用户以及 SaaS/MSP 平台运营者,提供统一的 AI 操作界面。核心场景包括:实时模块开发、通过 RPC 部署模块(无需文件系统访问)、多环境工作流、OCA 贡献流程、多客户数据库管理、按客户的记忆、自然语言查询销售数据、发票文档提取、语义搜索、邮件与日历协同,以及多租户托管与按租户计费集成。

主要能力

核心服务器 odoo-rpc-mcp 提供 197+ MCP 工具(92 个原生工具 + 105 个代理工具,覆盖 Portainer、GitHub、Teams、EE、OCA、文件系统),包含:

  • CRUD 与搜索:odoo_search_read、odoo_create、odoo_write、odoo_unlink、odoo_execute
  • 内省:odoo_fields_get、odoo_list_models、odoo_module_info
  • 多连接:odoo_connect、user_connection_activate,可在数据库间即时切换
  • Web 会话:odoo_web_login、odoo_web_call、odoo_web_export、odoo_web_report
  • 文件操作:odoo_attachment_upload、odoo_attachment_download、public_access_download
  • 报表:odoo_report、public_access_report_pdf、public_access_report_xlsx
  • 门户访问:public_access_portal_orders、public_access_portal_invoices、public_access_portal_tickets
  • 保加利亚本地化:odoo_fp_configure、odoo_fp_list、odoo_fp_details(适配 НАП 合规)
  • 翻译(2.10 引入):odoo_list_translatable_fields、odoo_get_field_translations、odoo_translate_field、odoo_translate_html,按版本适配(Odoo 16+ 原生 JSONB API,低于 16 用 ir.translation 回退),自动 ZWSP 标记已刻意保留的译文
  • 网站片段(2.10 引入):odoo_website_list_snippets、odoo_website_list_page_snippets、odoo_website_add_snippet、odoo_website_update_snippet、odoo_website_remove_snippet,基于 lxml 的 HTML 解析与 xpath 替换,覆盖博客、页面、产品描述和大型菜单
  • AI 集成:ai_tokenize_record、ai_search_similar、ai_collection_info(基于 Qdrant 向量嵌入)
  • 记忆系统:memory_read、memory_write、memory_share、memory_pull(支持按用户和共享记忆)
  • Google 服务:OAuth、Gmail 搜索/读取/发送、日历 CRUD
  • Telegram:MTProto 客户端,可发消息、搜索联系人、读取对话
  • SSH 与 Git:远程命令执行、Git 操作

辅助 MCP 服务器包括:

  • ee-mcp:Odoo 企业版工具,涵盖许可证验证、EE 模块仓库管理、依赖分析、EE 模块选择性链接、EE 与 OCA 模块冲突检测
  • oca-mcp:OCA 模块管理,支持克隆仓库、全量克隆、搜索本地 OCA 仓库、生成 README/图标/requirements.txt、分支迁移、从 newsfragments 生成变更日志
  • claude-terminal:基于 xterm.js + tmux + Claude Code 的浏览器终端,含 WebSocket 网关、按用户持久化 tmux 会话、可主题化终端(Catppuccin、Dracula、Tokyo Night、Gruvbox 等)、公共部署着陆页
  • 基础设施 MCP:github-mcp(代码/issue/PR/仓库搜索)、portainer-mcp(Docker/Kubernetes 环境管理)、teams-mcp(Microsoft Teams 消息)、filesystem-mcp(受作用域限制的文件系统操作)

配套 Odoo 模块:

  • l10n_bg_claude_terminal:免费/LGPL-3,将 MCP + Claude Terminal 配置暴露为 Odoo 用户偏好与公司设置,支持 Odoo 16、18、19(各主版本有独立分支)。功能含按用户的 MCP 端点和 Bearer 令牌、Odoo RPC 连接器、Web 会话凭据、Anthropic API 密钥/OAuth 透传、Telegram + Viber 配置、18 种终端主题、Claude.ai OAuth 登录按钮、实时刷新总线(MCP 写入触发表单/列表实时更新)、测试连接按钮、一键保存 MCP、动态 XML-RPC 数据库列表。非保加利亚部署可使用国际分支 rosenvladimirov/odoo-mcp-terminal(AGPL-3.0)。
  • l10n_bg_ai_billing:付费/OPL-1,SaaS 计费模块,含 8 个模型,支持套餐定价(Starter €49 / Business €129 / Professional €299 / Enterprise €599)、毫厘精度用量计费、Portainer 客户端包装器、AES-256 加密 ZIP 导出、技能目录、记忆包、保加利亚贸易登记集成、sale.order 集成、MCP Terminal 附加项。
  • odoo-mcp-theme:免费/AGPL-3,Odoo 19 网站主题,采用 OKLCH 纸墨+靛蓝配色、自定义片段、垂直时间线语言切换器、编辑排版,完全 #wrapwrap 作用域。

使用方式

提供三种部署选项:

  1. Docker Compose(本地开发):默认启动核心套件(Odoo RPC、Filesystem、OCA、EE、GitHub、Qdrant、Ollama、Claude Terminal),可选服务(Portainer、Teams)通过 Compose profile 启用,各可选服务需在 .env.example 中配置对应环境变量。无 Cloudflare 隧道时可使用覆盖文件。首次运行若 mcp-odoo-rpc 处于 Restarting 状态,需修正 .env 中的 ODOO_URL、ODOO_DB、ODOO_USERNAME、ODOO_API_KEY/ODOO_PASSWORD 指向可访问的 Odoo 实例。
  2. 安装脚本:Windows(以管理员身份运行 PowerShell)
  3. 连接 Claude Code:添加 MCP 配置或使用附带的 .mcp.json 生产环境推荐 Kustomize 部署于 k3s/ 目录,支持 cert-manager、Cloudflare 隧道与水平扩展。公共部署时通过网关的令牌认证确保只有授权 Claude 会话可连接,支持 Cloudflare Zero Trust 或简单隧道。该套件设计为可注册为 Claude.ai 自定义连接器(公共 HTTPS 端点 + 令牌认证),也可通过 l10n_bg_claude_terminal 模块中的 Claude.ai OAuth 登录按钮一键认证 Claude API。

限制

资料未提供具体性能指标、兼容的 Claude 客户端完整清单、价格以外的成本说明。使用效果取决于实际 Odoo 实例连通性及环境配置。当前处于 3.0 预览轨道(v3.3.8),稳定版本为 2.0 分支(v2.31.0)。