Odoo MCP Improved

🚀 Odoo MCP Improved

Odoo MCP Improvedは、Odoo ERPシステム向けのModel Context Protocol (MCP)の包括的な実装です。Claudeなどの大規模言語モデルとOdooインスタンスを橋渡しし、AIアシスタントが直接ビジネスデータとプロセスを操作できるようにします。

🚀 クイックスタート

Odoo MCP Improvedを使用するには、まずインストールと設定を行います。以下のセクションで詳細を説明します。

✨ 主な機能

コア機能

• シームレスなOdoo統合：XML-RPCを介して直接Odooインスタンスに接続します。
• 包括的なデータアクセス：すべてのOdooモジュールのデータを照会および操作できます。
• モジュール型アーキテクチャ：新しいツールやリソースで簡単に拡張できます。
• 堅牢なエラーハンドリング：信頼性の高い動作のための明確なエラーメッセージと検証機能が備わっています。

ビジネスドメインサポート

• 販売管理：注文追跡、顧客洞察、およびパフォーマンス分析を提供します。
• 購買管理：サプライヤー管理、注文処理、およびパフォーマンス指標を提供します。
• 在庫管理：在庫監視、在庫調整、および在庫回転率分析を提供します。
• 会計：財務報告、仕訳帳エントリ、および比率分析を提供します。

高度な機能

• 分析ツール：すべてのドメインにわたるビジネスインテリジェンス機能を提供します。
• 専用のプロンプト：一般的なビジネスシナリオ用の事前設定されたプロンプトが用意されています。
• リソースURI：URIパターンを通じたOdooデータへの標準化されたアクセスを提供します。
• パフォーマンス最適化：キャッシュと効率的なデータ取得機能が備わっています。

📦 インストール

pipを使用する場合

pip install odoo-mcp-improved

ソースからインストールする場合

git clone https://github.com/hachecito/odoo-mcp-improved.git
cd odoo-mcp-improved
pip install -e .

Dockerを使用する場合

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

⚙️ 設定

環境変数の設定

export ODOO_URL=https://your-odoo-instance.com
export ODOO_DB=your_database
export ODOO_USERNAME=your_username
export ODOO_PASSWORD=your_password

設定ファイルの作成

作業ディレクトリにodoo_config.jsonファイルを作成します。

{
  "url": "https://your-odoo-instance.com",
  "db": "your_database",
  "username": "your_username",
  "password": "your_password"
}

💻 使用例

サーバーの起動

# モジュールを使用する場合
python -m odoo_mcp

# Dockerを使用する場合
docker run -i --rm \
  -e ODOO_URL=https://your-odoo-instance.com \
  -e ODOO_DB=your_database \
  -e ODOO_USERNAME=your_username \
  -e ODOO_PASSWORD=your_password \
  yourusername/odoo-mcp-improved

サンプルの操作例

# 販売分析
Odoo MCPを使用して、前四半期の販売パフォーマンスを分析し、売上上位の製品を特定します。

# 在庫チェック
すべての倉庫における製品XYZの現在の在庫レベルを確認します。

# 財務分析
最新の財務データに基づいて、現在の流動性と収益性の比率を計算します。

# 顧客洞察
顧客ABCの購入履歴と支払いパターンに関する洞察を提供します。

📚 ドキュメント

ツールリファレンス

販売ツール

購買ツール

在庫ツール

会計ツール

リソースリファレンス

販売リソース

購買リソース

在庫リソース

会計リソース

プロンプト

Odoo MCP Improvedには、さまざまなビジネスシナリオ用の専用プロンプトが含まれています。

販売分析プロンプト

• 販売トレンド分析
• 顧客セグメンテーション
• 製品パフォーマンス評価
• 販売チームのパフォーマンス

在庫管理プロンプト

• 在庫最適化
• 再発注提案
• 倉庫効率分析
• 製品移動パターン

人事管理プロンプト

• スタッフ計画
• スケジューリング最適化
• パフォーマンス評価
• リソース割り当て

財務分析プロンプト

• 比率解釈
• キャッシュフロー分析
• 予算差異分析
• 財務健全性評価

🐳 Dockerサポート

Dockerでの実行

docker run -i --rm \
  -e ODOO_URL=https://your-odoo-instance.com \
  -e ODOO_DB=your_database \
  -e ODOO_USERNAME=your_username \
  -e ODOO_PASSWORD=your_password \
  yourusername/odoo-mcp-improved

Docker Composeの使用

version: '3'

services:
  odoo-mcp-improved:
    image: yourusername/odoo-mcp-improved:latest
    environment:
      - ODOO_URL=https://your-odoo-instance.com
      - ODOO_DB=your_database
      - ODOO_USERNAME=your_username
      - ODOO_PASSWORD=your_password

🤖 Claude Desktop統合

claude_desktop_config.jsonに以下の内容を追加します。

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "odoo_mcp"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_DB": "your_database",
        "ODOO_USERNAME": "your_username",
        "ODOO_PASSWORD": "your_password"
      }
    }
  }
}

Dockerを使用する場合：

{
  "mcpServers": {
    "odoo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "ODOO_URL",
        "-e", "ODOO_DB",
        "-e", "ODOO_USERNAME",
        "-e", "ODOO_PASSWORD",
        "yourusername/odoo-mcp-improved"
      ],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_DB": "your_database",
        "ODOO_USERNAME": "your_username",
        "ODOO_PASSWORD": "your_password"
      }
    }
  }
}

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

このリポジトリは mcp-odoo - Lê Anh Tuấn を拡張したものです。