Panda Odoo Mcp Server

mcp-odoo-panda

Odoo 用の MCP サーバー — Claude、Cursor、または任意の MCP クライアントから、Odoo ERP の検索、読み取り、作成、更新、およびメソッド呼び出しができます。

カスタムコネクターを作成せずに、LLM クライアント内で Odoo ツールを利用したい開発者やインテグレーター向けです。

クイックスタート

要件： Python 3.10 以降、アクセス可能な Odoo 15 以降のインスタンス（ローカルまたはリモート）。

1. インストール

   git clone https://github.com/pandeussilvae/mcp-odoo-panda.git
   cd mcp-odoo-panda
   pip install .
   

2. サンプルから設定

   cp odoo_mcp/config/config.example.yaml odoo_mcp/config/config.yaml
   # edit config.yaml — set odoo_url, database, username, api_key
   

3. クライアントの接続方法を選択（MCP プロトコルバージョン 2026-07-28 のみ）

   モード	用途
   stdio（デフォルト）	同じマシン上の Claude Desktop / Cursor（公式 mcp SDK）
   mcp_2026_07_28	リモートの Streamable HTTP（mcp_sdk_server 経由の POST /mcp）

   config.yaml で connection_type を設定してください（stdio と Streamable HTTP を参照）。

4. 実行

   odoo-mcp-server --config odoo_mcp/config/config.yaml
   # or: python -m odoo_mcp.core.mcp_server --config odoo_mcp/config/config.yaml
   

5. MCP クライアントに接続（Claude Desktop / Cursor） — Claude または Cursor に接続を参照してください。

Docker を使う場合：docker compose up -d（ラボ用スタック。 開発専用のデフォルト設定）。

最小構成の設定

コピーして使える設定の出発点（odoo_mcp/config/config.yaml）：

odoo_url: http://localhost:8069
database: your_database
username: your_username
api_key: your_password_or_api_key

protocol: xmlrpc
connection_type: stdio
transport_type: stdio

環境変数が設定されている場合、ファイル内の値より優先されます：ODOO_URL、ODOO_DB、ODOO_USER、ODOO_PASSWORD。

stdio と Streamable HTTP

どちらのトランスポートも、公式 Python mcp SDK（≥2.1.1）を介して MCP protocolVersion: 2026-07-28 を使用します。

• stdio — MCP クライアントがこのプロセスを起動し、stdin/stdout 経由で通信します（SDK のモダン版のみ）。デスクトップアプリ（Claude、Cursor）に最適です。ポートを開く必要はありません。
• mcp_2026_07_28（エイリアス http）— POST /mcp での Streamable HTTP（mcp_sdk_server + uvicorn）。リモート接続や Docker で使用します。

移行に関する注意

SSE / 2026-07-28 より前の HTTP は削除されました。 connection_type: sse、streamable_http、および modern_http は起動時に失敗します。クライアントを 2026-07-28 のエンベロープ（server/discover、リクエストごとの _meta）にアップグレードしてください。

HTTP の例（開発用）：

connection_type: mcp_2026_07_28
http:
  host: 127.0.0.1   # prefer loopback; 0.0.0.0 is DEV-ONLY
  port: 8080

Claude または Cursor に接続

Cursor — MCP サーバーのエントリーを追加します（Settings → MCP）。例：

{
  "mcpServers": {
    "odoo": {
      "command": "odoo-mcp-server",
      "args": ["--config", "/absolute/path/to/mcp-odoo-panda/odoo_mcp/config/config.yaml"]
    }
  }
}

Claude Desktop — MCP 設定ファイル（claude_desktop_config.json）に同じ形式で記述します。command と args で、インストール先と設定ファイルを指定してください。

絶対パスを使用してください。実際のパスワードを含むクライアント設定をコミットしないでください。

利用できる機能

• Odoo レコードの検索／読み取り／作成／書き込み／リンク解除
• カスタムモデルメソッドの呼び出し
• セッション管理、レート制限、オプションの HTTP CORS
• 公式 SDK による MCP Streamable HTTP（CONNECTION_TYPE=mcp_2026_07_28、プロトコル 2026-07-28）

セキュリティ

• 実際のパスワードや API キーを絶対にコミットしないでください。 config.yaml はローカルに保管してください（gitignore 対象です）。追跡対象は config.example.yaml のみです。
• Compose / Dockerfile の admin パスワードのデフォルト値は、ローカルのラボ環境でのみ使用する開発専用です。
• 0.0.0.0 へのバインドと allowed_origins: ["*"] の CORS 設定は開発専用です。本番環境ではループバックまたはプライベートインターフェースを使用し、オリジンを明示的に指定してください。
• 認証情報には環境変数またはシークレットマネージャーを使用することを推奨します。

スタンドアロン

このプロジェクトは、単一の Odoo 接続向けのスタンドアロンな MIT ライセンスの MCP サーバーです。マルチテナントの SaaS ゲートウェイではありません。ODWARD_BOUNDARY.md を参照してください。

オプション：上流エンジンとして Odward Connect で使用されています。この連携はこのリポジトリの外部にあります。

Deeper docs

Doc	Topic
CONFIGURATION.md	Full configuration reference
docs/API_REFERENCE.md	Tools / API
docs/DEVELOPER_GUIDE.md	Architecture for contributors
docs/DOCKER_DEPLOYMENT.md	Docker notes
docs/server_usage.md	Server usage
LEGGIMI.md	Italian quickstart

Historical refactor notes (when present) live under docs/archive/.

License

MIT — see LICENSE.

---

Developed by Paolo Nugnes and TechLab · [email protected] · [email protected]