贡献与许可证

感谢你帮助改进 MCP-Odoo-Tools。

基本规则

• 许可证： 贡献按 MIT 许可证接受。
• Clean-room（净室）： 不要 从采用 AGPL 许可证的 Odoo MCP 项目复制 代码。只依赖 Odoo 公开的 XML-RPC/JSON-RPC 接口，以及公开的模型/字段名称。
• 范围： 本仓库是公开的通用核心。本地化引擎、治理引擎或客户专属功能 （CFDI、审批门槛、备份等）另有其所。

服务器（Python）

cd server
python -m venv .venv && . .venv/bin/activate   # o usa uv
pip install -e ".[dev,cache]"
ruff check src tests
pytest -q

• 你要改动某个版本间的行为？编辑 src/odoo_mcp/compat/deltas.py（数据），并向 tests/test_compat_resolve.py 添加一行。无法在线上验证的边界， 应以 "best-effort" 作注释。
• 新工具？在 src/odoo_mcp/tools/ 中用 registry 装饰器注册它， 并在调用 ORM 之前先通过 compat 对模型/字段名称进行路由。

CLI（TypeScript）

cd cli && npm install && npm run build

Pull requests

• 保持改动聚焦；为逻辑包含测试。
• 当 deltas 映射表发生变化时，更新 docs/compat-matrix.md。
• 记录你验证过的任何新的 Odoo 版本/版本类型。

许可证

MIT © Transgenia (Centrum Transgenia S.A.S. de C.V.)。第三方署名参见 LICENSE 和 NOTICE。

署名

• odoo-agent (MIT) — 来自 Francisco Ramírez。复用了 TypeScript 的 XML-RPC CLI（cli/）、通用 Odoo 智能体的定义（agents/odoo.md， 经改编）、领域知识上下文，以及 SessionStart 钩子模式（经改编）。

Clean-room 声明

Python 编写的 MCP 服务器（server/）是一个原创且独立的实现。它 不 复制或 改编任何采用 AGPL 许可证的 Odoo MCP 项目的代码（包括 rosenvladimirov/odoo-claude-mcp 或其分支）。它仅依赖 Odoo 公开记载的 XML-RPC/JSON-RPC 接口，以及公开的模型/字段命名，而这些不受版权保护。 任何行为上的相似都反映了这些公开接口，而非共享代码。

Odoo 商标

"Odoo" 是 Odoo S.A. 的注册商标。本项目是一个独立的、面向社区的工具， 与 Odoo S.A. 既无隶属关系，也未获其背书。