Odoo MCP server for OpenCode

このワークスペースには、ローカル stdio MCP server (odoo_mcp) が同梱されています。自己ホスト型 Odoo のプロジェクトタスク、chatter、タイムシートを、エージェントが直接呼び出せる 9 つの型付きツールとして公開します。同じリポジトリには、元の 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 は、資格情報が平文の HTTP で送信されないよう、必ず絶対 HTTPS URL にしてください。

パスワードより 外部 API キーの使用を強く推奨します(Odoo: Preferences → Account Security → New API Key)。API キーは失効させることができ、Web ログインには使用できません。.env.example を .env にコピーして入力し、シェルに読み込むか、お好みのシークレット管理方法で変数を設定してください。MCP サーバーと CLI ヘルパーはどちらも、ワー、 クスペーース直下の .env があれ流自動で読み込みます。OpenCode またはシェルで設定済みの環境変数が優先されます。.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 でカバされています。