AI导哈

CRM自动化工具

一款AI驱动的CRM自动化工具，通过Model Context Protocol (MCP)将Claude AI与Odoo ERP系统集成，实现智能潜在客户分类、自动分配销售人员和实时项目管理。

  • by ajaysingh-codes
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ajaysingh-codes/odoo-mcp-server

使用说明

Odoo MCP服务器

🎯 Odoo MCP服务器

一种基于人工智能的CRM自动化工具，使用模型上下文协议（MCP）将Claude AI与Odoo ERP系统集成在一起。

🚀 特性

  • 🤖 AI线索分类：使用Claude AI和BANT方法（预算、权限、需求、时间线）自动对潜在客户进行分类
  • 📝 智能潜在客户创建：通过智能销售人员自动分配创建CRM潜在客户
  • 📊 项目管理：检索和管理Odoo项目任务
  • 🔄 实时集成：Claude对话和Odoo CRM之间的无缝连接
  • 🎨 用户友好界面：干净的Gradio web界面，便于交互

📋 先决条件

  • Python 3.8+
  • 访问Odoo实例（URL、数据库、凭据）
  • 来自Anthropic的Claude API密钥
  • 必需的Python包（见requirements.txt）

⚡ 快速开始

  1. 克隆存储库

    git clone <your-repo-url>
cd odoo-mcp-server

  2. 安装依赖项

    pip install -r requirements.txt

  3. 配置环境变量 创建一个 .env 项目根目录中的文件：

    # Odoo Configuration
ODOO_URL=https://your-odoo-instance.com
ODOO_DB=your_database_name
ODOO_USERNAME=your_username
ODOO_PASSWORD_OR_API_KEY=your_password_or_api_key

# Claude AI Configuration
CLAUDE_API_KEY=your_claude_api_key

  4. 测试您的Odoo连接

    python test_connection.py

  5. 启动应用程序

    python app.py

  6. 打开浏览器 向 http://localhost:7860

🛠️ 核心组件

使用BANT进行线索分类

AI分析电子邮件内容，并根据以下因素对潜在客户进行分类：

  • 预算：财务能力评估
  • 权威：决策权
  • 需要：紧迫性和重要性
  • 时间线：当他们需要解决方案时

智能自动分配

  • 根据电子邮件域匹配自动分配销售人员
  • 优先考虑来自知名公司的潜在客户
  • 根据资格更新潜在客户状态

项目任务管理

  • 从特定的Odoo项目中检索任务
  • 过滤和限制结果以进行集中管理
  • 实时项目状态更新

📖 使用示例

创建潜在客户

# Through the web interface or programmatically
result = mcp_create_odoo_lead(
    lead_title="Enterprise Software Inquiry",
    company="Tech Corp",
    contact="Jane Smith",
    email_address="jane@techcorp.com",
    phone_number="+1-555-0199",
    notes="Interested in our enterprise solution"
)

AI线索分类

# Classify an email and update the lead
email_content = """
Hi, I'm the CTO at StartupXYZ. We're looking for a CRM solution 
for our 50-person team. Our budget is around $10k annually, and 
we need something implemented within the next 2 months. 
Can you help?
"""

result = mcp_classify_and_update_lead(
    email_text=email_content,
    email_address="cto@startupxyz.com"
)

🔧 配置

环境变量

  • ODOO_URL：您的Odoo实例URL
  • ODOO_DB：数据库名称
  • ODOO_USERNAME：Odoo用户名
  • ODOO_PASSWORD_OR_API_KEY：密码或API密钥
  • CLAUDE_API_KEY：人类学Claude API密钥

定制

  • 修改BANT分类标准 app.py
  • 调整销售人员分配逻辑 odoo_actions.py
  • 在Gradio界面中自定义UI主题和布局

🔍 故障排除

常见问题

  1. Odoo连接失败

    • 验证您的Odoo URL和凭据
    • 检查您的Odoo实例是否允许XML-RPC连接
    • 确保您的用户具有适当的权限

  2. Claude API错误

    • 验证您的API密钥是否有效并且有足够的信用
    • 检查型号名称是否与可用的Claude型号匹配
    • 查看费率限制和使用情况

  3. JSON解析错误

    • 该应用程序处理来自Claude响应的markdown代码块
    • 检查控制台日志中Claude的响应格式

测试连接

python3 test_connection.py

🏗️ 建筑

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Gradio UI     │    │   Claude AI     │    │   Odoo ERP      │
│   (Frontend)    │◄──►│   (MCP Client)  │◄──►│   (Backend)     │
└─────────────────┘    └─────────────────┘    └─────────────────┘
        │                       │                       │
        │              ┌─────────────────┐              │
        └─────────────►│   Python App    │◄─────────────┘
                       │   (MCP Server)  │
                       └─────────────────┘

🎯 黑客马拉松亮点

该项目展示了：

  • 人工智能集成：无缝集成Claude AI，实现智能线索处理
  • 实际应用：实用的CRM自动化解决实际业务问题
  • 现代建筑：用于可扩展AI与人类协作的MCP协议实现
  • 用户体验：直观的界面使非技术用户可以访问AI

🤝 贡献

  1. 分叉存储库
  2. 创建要素分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

📄 许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

🙏 致谢

  • Claude AI和MCP协议的拟人化
  • Odoo为优秀的ERP平台
  • Gradio团队打造了出色的UI框架

相关 MCP