MCP-Odoo

基本能力

产品定位

MCP-Odoo是一个为Odoo ERP系统与AI代理之间提供桥梁的服务，通过Model Context Protocol（MCP）标准化接口，使AI系统能够访问和操作Odoo数据。

核心功能

• 🔌 与Odoo实例的轻松集成
• 🤖 标准MCP接口，兼容AI代理
• 📊 丰富的会计数据访问
• 🔒 安全的Odoo认证

适用场景

• 访问合作伙伴信息
• 查看和分析会计数据（包括发票和付款）
• 执行财务记录的对账
• 查询供应商账单和客户发票

工具列表

• mcp_odoo_public: 主程序包，包含Odoo客户端和相关模块
• resources/: MCP资源定义（工具和模式）
• server.py: MCP服务器实现
• config.py: 配置管理
• mcp_instance.py: FastMCP实例定义

常见问题解答

• 详细文档位于docs/目录下
• 包括实现指南、会计功能指南、故障排除和使用示例

使用教程

使用依赖

# 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

安装教程

1. 创建.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

1. 启动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/troubleshooting.md
• 使用示例位于docs/examples/basic_usage.md

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。