Odoo集成协议服务

MCP-Odoo是一个为Odoo ERP系统与AI代理提供标准接口的桥梁,支持访问合作伙伴信息、会计数据查询及财务记录对账等功能。

  • by yourtechtribe
  • Python
  • 本地部署
  • 14 星标
  • 更新于
在 GitHub 查看 yourtechtribe/model-context-protocol-mcp-odoo

使用说明

MP-Odo

用于Odoo集成的模型上下文协议服务器,允许AI代理通过标准化接口访问和操纵Odoo数据。

概述

MCP-Odoo使用模型上下文协议(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许可证获得许可-有关详细信息,请参阅许可证文件。

作者

阿尔贝·吉尔·洛佩斯

  • 电子邮件:albert.gil@yourtechtribe.com
  • 领英:https://www.linkedin.com/in/albertgilopez/

贡献

欢迎投稿!请随时提交拉取请求。