Odoo MCP Unified Server

Odoo MCP统一服务器🚀

统一Odoo模型上下文协议（MCP）服务器 具有双传输支持（stdio+SSE）、增强的业务工具和类型安全配置管理。

✨ 特性

🔌 双重运输支持

• 标准：用于Claude Desktop集成
• 上海证券交易所：用于web部署（Zeabur、Railway等）- 无需超级网关！

🛠️ 全套工具（17+工具）

核心工具（3）

• execute_method -执行任何Odoo方法（最强大）
• search_employee -搜索员工
• search_holidays -搜索假期/休息时间

销售工具（3）

• search_sales_orders -搜索销售订单
• create_sales_order -创建新的销售订单
• analyze_sales_performance -用趋势分析销售业绩

购买工具（3）

• search_purchase_orders -搜索采购订单
• create_purchase_order -创建新的采购订单
• analyze_supplier_performance -分析供应商准时交货

库存工具（2）

• get_stock_levels -获取当前库存水平
• predict_stock_needs -预测未来的库存需求

会计工具（2）

• get_financial_summary -获取财务概览
• analyze_receivables -分析应收账款

📦 资源（4）

• odoo://models -列出所有可用型号
• odoo://model/{model_name} -获取型号信息
• odoo://record/{model_name}/{record_id} -获取具体记录
• odoo://search/{model_name}/{domain} -搜索记录

⚙️ 配置管理

• Pydantic的类型安全配置
• 支持环境变量和JSON配置
• 启动验证

🚀 快速开始

适用于克劳德桌面（stdio模式）

1. 安装

cd E:\gitHub\odoo-mcp-unified
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
pip install -e .

1. 配置 -添加到Claude桌面配置(%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "odoo-unified": {
      "command": "E:\\gitHub\\odoo-mcp-unified\\venv\\Scripts\\python.exe",
      "args": ["E:\\gitHub\\odoo-mcp-unified\\run_server.py"],
      "env": {
        "ODOO_URL": "https://alpha-goods-corporation.odoo.com",
        "ODOO_DB": "alpha-goods-corporation",
        "ODOO_USERNAME": "your-username",
        "ODOO_PASSWORD": "your-password",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

1. 重新启动克劳德桌面

用于Zeabur部署（SSE模式）

1. 将GitHub仓库连接到Zeabur

1. 设置环境变量:

ODOO_URL=https://your-company.odoo.com
ODOO_DB=your-database
ODOO_USERNAME=your-username
ODOO_PASSWORD=your-password
MCP_TRANSPORT=sse
PORT=8000

1. 部署 -Zeabur将自动：

- 使用Dockerfile构建 - 暴露SSE端点 /sse - 无需超级网关！

📋 环境变量

必需

• ODOO_URL -Odoo实例URL
• ODOO_DB -数据库名称
• ODOO_USERNAME -用户名
• ODOO_PASSWORD -密码

可选的

• MCP_TRANSPORT -运输方式： stdio 或 sse （默认值： stdio)
• ODOO_TIMEOUT -请求超时（秒）（默认值： 60)
• ODOO_VERIFY_SSL -验证SSL证书（默认值： false)
• PORT -SSE模式的服务器端口（默认值： 8000)
• HOST -SSE模式的服务器主机（默认值： 0.0.0.0)
• LOG_LEVEL -日志记录级别（默认值： INFO)

📖 用法示例

执行任何Odoo方法

# Get product.product records
execute_method(
    model="product.product",
    method="search_read",
    args=[],
    kwargs={"fields": ["name", "list_price"], "limit": 10}
)

分析销售业绩

analyze_sales_performance(
    params={
        "start_date": "2024-01-01",
        "end_date": "2024-12-31",
        "group_by": "month"
    }
)

检查供应商绩效

analyze_supplier_performance(
    params={
        "supplier_id": 123,
        "start_date": "2024-01-01",
        "end_date": "2024-12-31"
    }
)

🏗️ 项目结构

odoo-mcp-unified/
├── src/odoo_mcp/
│   ├── __init__.py
│   ├── __main__.py
│   ├── server.py              # Main MCP server
│   ├── config.py              # 🆕 Configuration management
│   ├── odoo_client.py         # Odoo XML-RPC client
│   ├── extensions.py          # Extension registration
│   ├── models.py              # Pydantic models
│   ├── prompts.py             # MCP prompts
│   ├── resources.py           # MCP resources
│   ├── tools_sales.py         # Sales tools
│   ├── tools_purchase.py      # Purchase tools
│   ├── tools_inventory.py     # Inventory tools
│   └── tools_accounting.py    # Accounting tools
├── run_server.py              # 🆕 Unified server runner (stdio + SSE)
├── requirements.txt           # Fixed FastMCP version
├── pyproject.toml
├── Dockerfile                 # 🆕 Zeabur-ready
└── README.md

🔧 发展

运行测试

pytest tests/

在本地运行服务器（stdio）

export ODOO_URL=https://your-company.odoo.com
export ODOO_DB=your-database
export ODOO_USERNAME=your-username
export ODOO_PASSWORD=your-password
python run_server.py

在本地运行服务器（SSE）

export MCP_TRANSPORT=sse
export PORT=8000
python run_server.py
# Access: http://localhost:8000/sse

🐛 故障排除

✅ 使用最新稳定版本

该项目使用 最新稳定版本 快速MCP（>=0.7.0）和MCP（>=1.0.0）：

• 现代FastMCP API，无弃用参数
• 增强的性能和稳定性
• 最新功能和改进

SSL证书错误

如果您看到SSL错误：

export ODOO_VERIFY_SSL=false

连接超时

增加超时时间：

export ODOO_TIMEOUT=120

📦 v2.0中的新增功能

🆕 与odoo-mcp相比有所改善

• ✅ SSE传输支持（无超级网关的Zeabur部署）
• ✅ 统一的config.py模块（类型安全配置）
• ✅ 单代码库中的双传输模式
• ✅ 增强文档

🆕 与mcp-odoo相比

• ✅ 所有基本功能（execute_method、资源）
• ✅ 12+附加业务工具
• ✅ 扩展系统
• ✅ SSE支持
• ✅ 更好的错误处理

📄 许可证

MIT许可证

🤝 贡献

欢迎投稿！请打开问题或PR。

🔗 链接

• 模型上下文协议
• Odoo文档
• FastMCP

______________________________________________________________________

由...制作❤️ 阿尔法商品公司