Odoo MCP server for OpenCode

本工作区附带一个本地 stdio MCP 服务器（odoo_mcp），它将你自托管的 Odoo 项目任务、讨论记录（chatter）和工时记录以九个类型化工具的形式暴露出来，供 agent（智能体）直接调用。同一仓库仍保留原始的 odoo_tasks.py CLI——行为不变——它与 MCP 服务器共享服务层。

前置条件

• Python 3.10+（工作区基于 3.12 开发）

• uv 已在 PATH 中（如缺失，执行 pip install uv）

一次性安装全部依赖：

uv sync

Related MCP server: MCP Server for Odoo

凭据（环境变量）

ODOO_URL 必须是绝对 HTTPS URL，确保凭据绝不会通过明文 HTTP 传输。

强烈建议使用 API 密钥而不是密码（Odoo：首选项 → 账户安全 → 新建 API 密钥）：它可以被撤销，且不能用于网页登录。将 .env.example 复制为 .env，填写内容，再加载到你的 shell 中，或者按照你管理密钥的方式设置这些变量。当工作区根目录存在 .env 时，MCP 服务器和 CLI 辅助工具都会自动加载它；已经由 OpenCode 或 shell 设置的环境变量优先。切勿提交 .env。

插值注意事项： opencode.json 使用 {env:VAR} 占位符。如果某个变量在 OpenCode 启动时缺失，它会变成空字符串，然后每次工具调用都会以清晰的错误信息失败，指出缺失的变量（Missing required environment variables: ODOO_USERNAME, ...），而不是把错误的凭据发往任何地方。任何值都不会被回显到日志或结果中。

如何向 OpenCode 注册

本工作区的 opencode.json 已经包含：

{
  "mcp": {
    "odoo": {
      "type": "local",
      "command": ["uv", "run", "python", "-m", "odoo_mcp"],
      "environment": { "...": "{env:ODOO_*} placeholders" },
      "enabled": true
    }
  }
}

OpenCode 在启动时加载配置——在修改凭据或此文件之后，退出并重启 OpenCode 即可使其生效。服务器只在每次会话中通过 stdio 生成一次；没有任何网络端口在监听。

工具

修改类工具默认立即执行；其中每个工具都可接受 dry_run=true 标志，该标志会先返回预览而不写入任何内容。

状态码因 Odoo 构建版本而异——先调用 get_task_states 而不是猜测；无效状态会被拒绝并附带有有效状态码，再返回安全使用。

验证安装

uv sync                                              # deps resolve
uv run pytest tests -q                               # protocol + service suites
uv run python -m unittest discover -s tests -v       # CLI characterization suite
uv run python odoo_tasks.py --help                   # legacy CLI still intact

stdio 握手过程本身由 tests/test_stdio_smoke.py 覆盖。