MCP Odoo

🚀 Odoo MCP サーバー

Odoo ERP システムに統合された MCP サーバーの実装で、AI アシスタントが Model Context Protocol（モデルコンテキストプロトコル）を介して Odoo のデータとサービスとやり取りできるようにします。

✨ 主な機能

• Odoo との完全統合：Odoo のモデル、レコード、メソッドに完全にアクセス可能
• XML - RPC 通信：XML - RPC を通じて Odoo インスタンスに安全に接続
• 柔軟な設定：設定ファイルと環境変数の使用をサポート
• リソースモードシステム：URI を基に Odoo のデータ構造にアクセス
• エラー処理：一般的な Odoo API の問題に対して明確なエラーメッセージを提供
• ステートレス操作：信頼性の高い統合を実現するクリーンなリクエスト/レスポンスサイクル

🛠️ ツール

execute_method

• Odoo モデル上でカスタムメソッドを実行します。
  • 入力：
    • model（文字列）：モデル名
    • method（文字列）：実行するメソッド名
    • args（オプションの配列）：メソッドに渡す引数のリスト
    • kwargs（オプションのオブジェクト）：メソッドに渡すキーワード引数
  • 出力：
    • メソッドの実行結果

search_employee

• 従業員情報を検索します。
  • 入力：
    • criteria（文字列/オブジェクト）：検索条件。リスト形式または JSON オブジェクトをサポート
    • fields（オプションの配列）：返すフィールドのリスト
  • 出力：
    • 条件に合致する従業員レコード

search_holidays

• 休暇情報を検索します。
  • 入力：
    • date_range（文字列）：日付範囲。"YYYY - MM - DD" 形式
    • employee_id（オプションの整数）：特定の従業員 ID
  • 出力：
    • 条件に合致する休暇レコード

📚 リソース

• Odoo モデル：odoo://models
• Odoo レコード：odoo://records/{model_name}/{id}
• Odoo メソッド：odoo://methods/{model_name}/{method_name}

📦 インストール

Python パッケージのインストール

pip install odoo-mcp

サーバーの起動

# インストールしたパッケージを使用
odoo-mcp

# MCP 開発ツールを使用
mcp dev odoo_mcp/server.py

# 追加の依存関係を含む
mcp dev odoo_mcp/server.py --with pandas --with numpy

# 開発用にローカルコードをマウント
mcp dev odoo_mcp/server.py --with-editable .

Docker ビルド

docker build -t mcp/odoo:latest -f Dockerfile .

📋 パラメータ形式の説明

MCP ツールを使用する際は、以下のパラメータ形式のガイドラインに注意してください。

ドメインパラメータ

• 以下のフィールド形式をサポートします。
  • リスト形式：[["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"]]

フィールドパラメータ

• フィールド名の配列である必要があります：["name", "email", "phone"]
• サーバーは文字列入力を JSON として解析しようとします。

📄 ライセンス

この MCP サーバーは MIT License（MIT）の下でライセンスされています。