Odoo Accounting

🚀 MCP-Odoo 模型上下文協議服務器

MCP-Odoo 模型上下文協議服務器用於 Odoo 集成，它為 AI 代理提供了標準化接口，方便其訪問和操作 Odoo 數據，極大地提升了數據交互的效率和便捷性。

🚀 快速開始

MCP-Odoo 藉助模型上下文協議（MCP），在 Odoo ERP 系統與 AI 代理之間搭建了溝通的橋樑。這使得 AI 系統能夠輕鬆實現以下功能：

• 訪問合作伙伴信息。
• 查看並分析會計數據，涵蓋發票和付款記錄。
• 執行財務記錄的對賬操作。
• 查詢供應商賬單和客戶發票。

✨ 主要特性

• 🔌 可簡便地與 Odoo 實例進行集成。
• 🤖 具備 MCP 接口兼容性，能與 AI 代理實現互聯。
• 📊 支持豐富的會計數據訪問。
• 🔒 採用安全的身份驗證與 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 的方式參與開發。