Odoo Accounting

🚀 MCP-Odoo モデルコンテキストプロトコルサーバ

MCP-Odoo モデルコンテキストプロトコルサーバは、Odoo との統合を可能にし、AI エージェントが標準化されたインターフェースを通じて Odoo データにアクセスし操作することを可能にします。

🚀 クイックスタート

MCP-Odoo は、モデルコンテキストプロトコル（MCP）を使用して、Odoo ERP システムと AI エージェントの間に橋渡しをします。これにより、AI システムは以下のことができます。

• 取引先情報にアクセスする
• 請求書や支払い記録などの会計データを表示し分析する
• 財務記録の照合を実行する
• 仕入先請求書や顧客請求書を照会する

✨ 主な機能

• 🔌 Odoo インスタンスへの簡単な統合
• 🤖 AI エージェントとの相互接続を実現する MCP インターフェース互換性
• 📊 豊富な会計データへのアクセス
• 🔒 Odoo 統合における安全な認証

📦 インストール

# リポジトリをクローンする
git clone https://github.com/yourtechtribe/model-context-protocol-mcp-odoo.git
cd model-context-protocol-mcp-odoo

# 依存関係をインストールする
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 サーバを起動します。

# SSE 伝送を使用する（デフォルト）
python -m mcp_odoo_public

# ローカルエージェント統合のために stdio を使用する
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

• メール：albert.gil@yourtechtribe.com
• LinkedIn：https://www.linkedin.com/in/albertgilopez/

🤝 貢献ガイド

このプロジェクトに貢献したい場合は、作者情報と貢献ガイドを参考に、Pull Request を提出して開発に参加することができます。