🚀 Odoo MCP 多租户代理
通过MCP协议将您的Odoo实例连接到ChatGPT、Claude和其他AI代理。
一个完整的多租户解决方案，让您的Odoo对接现代AI代理。2分钟内完成配置，通过令牌进行安全保护，兼容所有支持MCP协议的AI代理。
______________________________________________________________________
✨ 功能
- 🔌（电源插头/插座） 原生MCP集成 - 兼容ChatGPT、Claude及所有AI代理
- 🏢 翻译为中文是：办公楼/公司大楼。 多租户 - 从一个应用程序管理多个Odoo实例
- 🔒 表示“锁”或“安全”的符号，常用于表示密码保护、安全访问等含义。 安全的 - API令牌认证、加密、符合GDPR（通用数据保护条例）合规性
- ⚡（闪电符号，常用于表示速度、活力或电力等） 快速 - 2分钟内完成配置，无需复杂安装
- 🔄 旋转（或循环） 实时 - 与您的Odoo数据即时同步
- 📊（图表） 分析（或分析学） - 通过详细指标跟踪使用情况
🎯 使用场景
💬 支持智能客户端
ChatGPT可以直接在Odoo中查看订单、发票和客户历史记录，以提供超快速支持。
📊 数据分析
人工智能分析您的销售数据、预测和关键绩效指标，以提供实时可操作的见解。
🤖 自动化
在Odoo与您的AI工具之间创建自动化工作流，以节省时间。
🎯 客户关系管理（CRM）与销售
自动筛选潜在客户，产品推荐及销售预测。
______________________________________________________________________
🚀 快速入门
先决条件
- Python 3.8及以上版本
- 一个可访问的Odoo实例
- 一个可以上网的服务器（VPS、云服务器等）
安装（5分钟）
# 1. Cloner le repo
git clone https://github.com/bycommute/odoo-mcp-proxy-multi-tenant.git
cd odoo-mcp-proxy-multi-tenant
# 2. Créer un environnement virtuel
python3 -m venv venv
source venv/bin/activate # Linux/Mac
# ou
.\venv\Scripts\activate # Windows
# 3. Installer les dépendances
pip install -r requirements.txt
# 4. Lancer le serveur
python app/mcp_multi_tenant_server.py --host=0.0.0.0 --port=8080🎉（庆祝、欢呼等意思的符号，可翻译为“庆祝”或根据语境灵活处理，此处直接保留原符号以表达其作为表情符号的用途） 就这样！ 打开 http://localhost:8080 在您的浏览器中。
______________________________________________________________________
📖 文档
| 指南 | 描述 |
|---|---|
| 🚀 部署 | 在Hostinger、AWS等平台上的完整部署指南 |
| 🔒 HTTPS 设置 | 配置域名和SSL（Let's Encrypt） |
| 🎨 前端架构 | 前端结构与设计 |
| 📁 项目结构 | 代码组织 |
______________________________________________________________________
🏗️ 建筑学
┌─────────────────┐
│ ChatGPT/ │
│ Claude/ │ MCP Protocol
│ Agents IA │ (JSON-RPC 2.0)
└────────┬────────┘
│
│ HTTPS + Bearer Token
▼
┌─────────────────────────────┐
│ Odoo MCP Proxy │
│ (FastAPI + FastMCP) │
│ │
│ • Authentification │
│ • Multi-tenant │
│ • MCP Tools │
└────────┬────────────────────┘
│
│ XML-RPC
▼
┌─────────────────┐
│ Odoo Instance │
│ (Votre ERP) │
└─────────────────┘______________________________________________________________________
🛠️ 技术
- 后端： FastAPI - 现代网络框架
- MCP: FastMCP - MCP实施
- 数据库SQLite（或 PostgreSQL）
- 前端HTML5，CSS3，JavaScript（原生）
- 部署Nginx，Gunicorn，Systemd
______________________________________________________________________
📦 项目结构
odoo-mcp-proxy-multi-tenant/
├── app/
│ ├── core/ # Composants principaux
│ │ ├── database.py # Configuration DB
│ │ ├── models.py # Modèles (User, APIToken)
│ │ └── odoo_client.py # Client Odoo RPC
│ └── mcp_multi_tenant_server.py # Serveur principal
│
├── frontend/
│ ├── css/ # Styles
│ ├── js/ # JavaScript
│ ├── use-cases/ # Pages de cas d'usage
│ ├── index.html # Landing page
│ └── test.html # Page de test
│
├── docs/ # Documentation
├── scripts/ # Scripts de déploiement
└── tests/ # Tests______________________________________________________________________
🔐 安全
- ✅ 使用Bearer Token进行身份验证
- ✅ 每个实例独有的Tokens API
- ✅ 数据传输加密（HTTPS）
- ✅ 安全头部（HSTS、CSP 等）
- ✅ 输入验证
- ✅ 速率限制（可选）
______________________________________________________________________
🌐 部署
选项1：快速部署（Hostinger VPS）
./scripts/deploy_mcp_hostinger.sh选项2：使用HTTPS进行部署
# 1. Configurer votre domaine (DNS A record)
# 2. Lancer le script
./scripts/setup_https.sh votre-domaine.com查看 部署指南 以了解更多详情。
______________________________________________________________________
🧪 测试
# Tests rapides
./tests/quick_test.sh
# Tests complets
python tests/run_all_tests.py
# Test de déploiement
./tests/test_deployment.py______________________________________________________________________
🤝 贡献
欢迎投稿！
- 克隆该项目
- 创建一个分支（
git checkout -b feature/AmazingFeature） - 提交您的更改（
git commit -m 'Add some AmazingFeature') - 推送到分支（
git push origin feature/AmazingFeature) - 提交一个拉取请求
______________________________________________________________________
📝 路线图
- \[x\] 后端MCP多租户
- \[x\] 优化后的着陆页SEO
- \[x\] 3种使用场景（支持、分析、客户关系管理）
- \[x\] 自动化部署脚本
- \[x\] 完整文档
- \[ \] 用户仪表盘
- \[ \] 认证系统（账户）
- \[ \] 3个额外使用案例（电子邮件、金融、自动化）
- \[ \] 高级分析
- \[ \] 附加REST API
- \[ \] 支持 PostgreSQL
- \[ \] Docker/Docker Compose（可选）
- \[ \] 监控（Prometheus/Grafana）
______________________________________________________________________
📄 许可证
这个项目采用MIT许可证。详见 许可证 以了解更多详情。
______________________________________________________________________
🙏 感谢
- 模型上下文协议 - MCP协议
- FastAPI - 网络框架
- FastMCP - 实施MCP（多协议控制器/管理控制计划/其他根据上下文确定的MCP含义）
- Odoo（中文可译为“奥多”或直接保留原名，根据上下文决定是否需要翻译） - 开源ERP（企业资源计划）
______________________________________________________________________
📞 支持
- 📧 电子邮件：support@bycommute.com
- 🐞 问题：
- 💬 讨论：
______________________________________________________________________