MCP-Odoo

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

概述

MCP-Odoo 使用模型上下文协议 (MCP) 在 Odoo ERP 系统和 AI 代理之间架起了一座桥梁。这使得 AI 系统能够：

• 访问合作伙伴信息

• 查看和分析包括发票和付款在内的会计数据

• 执行财务记录的核对

• 查询供应商账单和客户发票

Related MCP server: Odoo MCP Improved

特征

• 🔌 轻松与 Odoo 实例集成

• 🤖 标准 MCP 接口，兼容 AI 代理

• 📊 丰富的会计数据访问

• 🔒 使用 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 文件。

作者

阿尔伯特·吉尔·洛佩斯

• 电子邮件： albert.gil@yourtechtribe.com

• 领英： https://www.linkedin.com/in/albertgilopez/

贡献

欢迎贡献代码！欢迎提交 Pull 请求。