MCP-Odoo

MCP-Odoo

Odoo と統合するための Model Context Protocol サーバーです。標準化されたインターフェースを通じて、AI エージェントが Odoo のデータにアクセスし、操作できるようにします。

概要

MCP-Odoo は、Model Context Protocol（MCP）を使用して Odoo ERP システムと AI エージェントをつなぎます。これにより、AI システムは次のことができるようになります。

• 取引先情報へのアクセス
• 請求書や支払いを含む会計データの閲覧と分析
• 財務記録の照合
• 仕入先請求書と顧客向け請求書の照会

機能

• 🔌 Odoo インスタンスとの簡単な統合
• 🤖 AI エージェントとの互換性を備えた標準 MCP インターフェース
• 📊 豊富な会計データへのアクセス
• 🔒 Odoo による安全な認証

インストール

# Clone the repository
git clone https://github.com/yourtechtribe/model-context-protocol-mcp-odoo.git
cd model-context-protocol-mcp-odoo

# Install dependencies
pip install -r requirements.txt

設定

プロジェクトのルートに .env ファイルを作成し、次の変数を設定します。

ODOO_URL=https://your-odoo-instance.com
ODOO_DB=your_database
ODOO_USERNAME=your_username
ODOO_PASSWORD=your_password
HOST=0.0.0.0
PORT=8080

使用方法

MCP サーバーを起動します。

# Using the SSE transport (default)
python -m mcp_odoo_public

# Using stdio for local agent integration
python -m mcp_odoo_public --transport stdio

ドキュメント

包括的なドキュメントは docs/ ディレクトリにあります。

• ドキュメントのホーム - すべてのドキュメントの概要はこちらからご覧ください
• 実装ガイド - アーキテクチャと実装の詳細
• 会計機能 - 会計機能の詳細ガイド
• トラブルシューティング - よくある問題の解決方法
• 使用例 - 利用を始めるための実践的な例

開発

プロジェクト構成

• mcp_odoo_public/：メインパッケージ
  • odoo/：Odoo クライアントと関連モジュール
  • resources/：MCP リソースの定義（ツールとスキーマ）
  • server.py：MCP サーバーの実装
  • config.py：設定管理
  • mcp_instance.py：FastMCP インスタンスの定義

新しいリソースの追加

リソースは、MCP を通じて AI エージェントに公開される機能を定義します。新しいリソースを追加するには、次の手順に従います。

1. resources/ ディレクトリに新しいファイルを作成します
2. @mcp.tool() デコレーターを使ってリソースを定義します
3. resources/__init__.py でリソースをインポートします

詳しい手順については、実装ガイドをご覧ください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルをご覧ください。

作者

Albert Gil López

• メール：[email protected]
• LinkedIn：https://www.linkedin.com/in/albertgilopez/

貢献

貢献を歓迎します。お気軽に Pull Request を送信してください。