🚀 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 的方式参与开发。