IM

ivnvxd/mcp-server-odoo

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

409 stars 191 forks 品質 91 トレンド 40MPL-2.0

モデルコンテキストプロトコル(MCP)サーバーは、AIアシスタントが標準化されたリソースとツールを通じてOdooのERPシステムと安全に連携し、データ取得や操作を可能にします。

概要

ClaudeのようなAIアシスタントがOdooのERPシステムとやり取りできるようにするMCPサーバーです。ビジネスデータへのアクセス、レコード検索、新規エントリの作成、既存データの更新、Odooインスタンスの管理を自然言語で行えます。 標準的なOdooインストール時には、YOLOモードを使い、素早いテストやデモを行ってください。エンタープライズセキュリティ、アクセス制御、本番環境での使用には、Odoo MCPモジュールをインストールしてください。 - 🔍 任意のOdooレコード(顧客、製品、請求書など) - ✨ フィールド検証と権限チェック付き - ✏️ スマートフィールドハンドリング - 🗑️ モデルレベルの権限尊重 - 🔢 特定の基準に適合 - 📋 データ構造を理解するための - 📊 - 生の行を引かずにグループ化、合計、カウント - ⚡ — 公開のOdooメソッドを呼び出す(請求書の発行、SO確認など)

概要(AI 翻訳)

ClaudeのようなAIアシスタントがOdooのERPシステムとやり取りできるようにするMCPサーバーです。ビジネスデータへのアクセス、レコード検索、新規エントリの作成、既存データの更新、Odooインスタンスの管理を自然言語で行えます。

どのOdooインスタンスでも動作! 標準的なOdooインストールでは、YOLOモードを使い、迅速なテストやデモを行います。エンタープライズセキュリティ、アクセス制御、本番環境での使用には、Odoo MCPモジュールをインストールしてください。

特徴

  • 🔍 **Odooのレコード(顧客、商品、請求書など)を検索・取得
  • ✨ フィールド検証および権限チェックを伴う新しいレコードを作成する
  • ✏️ スマートフィールド処理で既存データを更新
  • 🗑️ レコードを削除 モデルレベルの権限を尊重する
  • 🔢 特定の基準に合致する記録を数える
  • 📋 データ構造を理解するためにモデルフィールドを検査
  • 📊 サーバー側の集約 — 生の行を引き出さずにグループ化、合計、カウントを行う
  • ⚡ ワークフローアクション — オプトインのエスケープハッチを介して公開ビジネスメソッド(請求書の投稿、SO確認など)を呼び出す
  • 📎 バイナリおよび添付リソース — リソースURIを通じて画像、ドキュメント、ir.attachmentファイルを取得

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

MCP Server for Odoo

An MCP server that enables AI assistants like Claude to interact with Odoo ERP systems. Access business data, search records, create new entries, update existing data, and manage your Odoo instance through natural language.

Works with any Odoo instance! Use YOLO mode for quick testing and demos with any standard Odoo installation. For enterprise security, access controls, and production use, install the Odoo MCP module.

Features

  • 🔍 Search and retrieve any Odoo record (customers, products, invoices, etc.)
  • ✨ Create new records with field validation and permission checks
  • ✏️ Update existing data with smart field handling
  • 🗑️ Delete records respecting model-level permissions
  • 🔢 Count records matching specific criteria
  • 📋 Inspect model fields to understand data structure
  • 📊 Server-side aggregation — group, sum, and count without pulling raw rows
  • ⚡ Workflow actions — invoke public business methods (post invoice, confirm SO, etc.) via an opt-in escape hatch
  • 📎 Binary & attachment resources — fetch images, documents, and ir.attachment files via resource URIs
  • 👤 Personalized session context — the connected user, timezone, and company scope injected into the session instructions
  • 🔐 Secure access with API key or username/password authentication
  • 🎯 Smart pagination for large datasets
  • 🧠 Smart field selection — automatically picks the most relevant fields per model
  • 💬 LLM-optimized output with hierarchical text formatting
  • 🌍 Multi-language support — get responses in your preferred language
  • 🚀 YOLO Mode for quick access with any Odoo instance (no module required)

Installation

Prerequisites

  • Python 3.10 or higher
  • Access to an Odoo instance:
    • Standard mode (production): Version 16.0+ with the Odoo MCP module installed
    • YOLO mode (testing/demos): Any Odoo version with XML-RPC enabled (no module required)

Install UV First

GitHub で README 全文を見る

インストール

uvx mcp-server-odoo
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "odoo": { "command": "uvx", "args": ["mcp-server-odoo"], "env": { "ODOO_URL": "https://your-odoo-instance.com", "ODOO_API_KEY": "your-api-key-here" } } } }