MCP-Odoo

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

概述

MCP-Odoo在Odoo ERP系统和使用模型上下文协议（MCP）的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文件。

作者

Albert Gil López

• 邮件：albert.gil@yourtechtribe.com
• LinkedIn：https://www.linkedin.com/in/albertgilopez/

贡献

欢迎贡献！请随意提交Pull Request。