Odoo MCP Server

Odoo MCP サーバー

Odoo ERP システムと統合する MCP サーバー実装。AI アシスタントがモデル コンテキスト プロトコルを通じて Odoo のデータや機能と対話できるようになります。

特徴

• 包括的なOdoo統合：Odooモデル、レコード、メソッドへのフルアクセス
• XML-RPC 通信: XML-RPC 経由の Odoo インスタンスへの安全な接続
• 柔軟な構成: 構成ファイルと環境変数のサポート
• リソースパターンシステム: Odooデータ構造へのURIベースのアクセス
• エラー処理: 一般的な Odoo API の問題に関する明確なエラーメッセージ
• ステートレス操作: 信頼性の高い統合のためのクリーンなリクエスト/レスポンス サイクル

ツール

• 検索レコード
  • 任意のOdooモデルのレコードを検索する
  • 入力:
    • model (文字列): モデル名 (例: 'res.partner')
    • domain （配列）：検索ドメイン（例：[['is_company', '=', true]]）
    • fields (オプション配列): 取得するオプションフィールド
    • limit (オプションの数値): 返されるレコードの最大数
  • 戻り値: 要求されたフィールドと一致するレコード
• レコード読み取り
  • 特定のレコードの詳細を読む
  • 入力:
    • model (文字列): モデル名 (例: 'res.partner')
    • id (数値): レコードID
    • fields (オプション配列): 取得するオプションフィールド
  • 戻り値: 要求されたフィールドを持つレコードデータ
• レコード作成
  • Odooで新しいレコードを作成する
  • 入力:
    • model (文字列): モデル名 (例: 'res.partner')
    • values (オブジェクト): フィールド値の辞書
  • 戻り値: 新しいレコードIDを持つ辞書
• 更新レコード
  • 既存のレコードを更新する
  • 入力:
    • model (文字列): モデル名 (例: 'res.partner')
    • id (数値): レコードID
    • values (オブジェクト): 更新するフィールド値の辞書
  • 戻り値: 成功を示す辞書
• レコードの削除
  • Odooからレコードを削除する
  • 入力:
    • model (文字列): モデル名 (例: 'res.partner')
    • id (数値): レコードID
  • 戻り値: 成功を示す辞書
• 実行メソッド
  • Odoo モデルでカスタムメソッドを実行する
  • 入力:
    • model (文字列): モデル名 (例: 'res.partner')
    • method (文字列): 実行するメソッド名
    • args (オプション配列): 位置引数
    • kwargs (オプションオブジェクト): キーワード引数
  • 戻り値: メソッドの結果を含む辞書
• get_model_fields
  • モデルのフィールド定義を取得する
  • 入力:
    • model (文字列): モデル名 (例: 'res.partner')
  • 戻り値: フィールド定義を含む辞書
• 従業員検索
  • 名前で従業員を検索します。
  • 入力:
    • name (文字列): 検索する名前 (または名前の一部)。
    • limit (オプションの数値): 返される結果の最大数 (デフォルトは 20)。
  • 返される値: 一致する従業員名と ID のリスト。
• 検索休日
  • 指定された日付範囲内の休日を検索します。
  • 入力:
    • start_date (文字列): YYYY-MM-DD 形式の開始日。
    • end_date (文字列): YYYY-MM-DD 形式の終了日。
    • employee_id (オプションの数値): 休日をフィルタリングするためのオプションの従業員 ID。
  • 返される値: 見つかった休日のリスト。

リソース

• odoo://モデル
  • Odoo システムで利用可能なすべてのモデルを一覧表示します
  • 戻り値: モデル情報のJSON配列
• odoo://model/{モデル名}
  • フィールドを含む特定のモデルに関する情報を取得する
  • 例: odoo://model/res.partner
  • 戻り値: モデルメタデータとフィールド定義を含むJSONオブジェクト
• odoo://record/{モデル名}/{レコードID}
  • IDで特定のレコードを取得する
  • 例: odoo://record/res.partner/1
  • 戻り値: レコードデータを含むJSONオブジェクト
• odoo://search/{モデル名}/{ドメイン}
  • ドメインに一致するレコードを検索する
  • 例: odoo://search/res.partner/[["is_company","=",true]]
  • 戻り値: 一致するレコードの JSON 配列 (デフォルトでは 10 に制限されます)

構成

Odoo接続設定

1. odoo_config.jsonという名前の設定ファイルを作成します。

2. あるいは、環境変数を使用します。
   • ODOO_URL : Odoo サーバーの URL
   • ODOO_DB : データベース名
   • ODOO_USERNAME : ログインユーザー名
   • ODOO_PASSWORD : パスワードまたはAPIキー
   • ODOO_TIMEOUT : 接続タイムアウト（秒）（デフォルト: 30）
   • ODOO_VERIFY_SSL : SSL証明書を検証するかどうか（デフォルト: true）
   • HTTP_PROXY : ODOO 接続に HTTP プロキシを使用するように強制します

Claude Desktopでの使用

これをclaude_desktop_config.jsonに追加します:

ドッカー

インストール

Pythonパッケージ

サーバーの実行

建てる

Dockerビルド:

パラメータのフォーマットガイドライン

Odoo 用の MCP ツールを使用する場合は、次のパラメータ書式設定ガイドラインに注意してください。

1. ドメインパラメータ:
   • 次のドメイン形式がサポートされています。
     • リスト形式: [["field", "operator", value], ...]
     • オブジェクト形式: {"conditions": [{"field": "...", "operator": "...", "value": "..."}]}
     • いずれかの形式のJSON文字列
   • 例:
     • リスト形式: [["is_company", "=", true]]
     • オブジェクト形式: {"conditions": [{"field": "date_order", "operator": ">=", "value": "2025-03-01"}]}
     • 複数の条件: [["date_order", ">=", "2025-03-01"], ["date_order", "<=", "2025-03-31"]]
2. フィールドパラメータ:
   • フィールド名の配列である必要があります: ["name", "email", "phone"]
   • サーバーは文字列入力をJSONとして解析しようとします

ライセンス

この MCP サーバーは MIT ライセンスに基づいてライセンスされます。