🚀 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 代理的能力。要添加新的资源：
- 在
resources/目录下创建一个新的文件。 - 使用
@mcp.tool()装饰器定义您的资源。 - 将您的资源导入到
resources/__init__.py中。
有关详细说明，请参阅 实施指南。
📄 许可证
该项目使用 MIT License - 请查看 LICENSE 文件以获取详细信息。
👨💻 作者信息
Albert Gil López
- 邮箱：albert.gil@yourtechtribe.com
- LinkedIn：https://www.linkedin.com/in/albertgilopez/
🤝 贡献指南
如果有兴趣为该项目做出贡献，可以参考作者信息和贡献指南，通过提交 Pull Request 的方式参与开发。