Odoo MCP Server

# MCP服务器模块部署指南 ## 快速部署 ### 1. 安装依赖 ```bash pip install -r requirements.txt ``` ### 2. 安装模块 ```bash # 将mcp_server目录复制到Odoo addons路径 cp -r mcp_server /path/to/odoo/addons/ # 更新模块列表并安装 odoo-bin -u mcp_server -d your_database ``` ### 3. 验证安装 安装完成后，系统会自动： 1. **创建多个服务器**：默认服务器（端口10888）和演示服务器（端口10889、10890） 2. **自动启动活动服务器**：默认服务器会自动启动 3. **创建默认资源**：包括Odoo模型访问和服务器信息资源 4. **端口自动分配**：每个新服务器自动分配可用端口 ## 自动启动验证 ### 检查服务器状态 1. 导航到 **MCP服务器 > 服务器** 2. 查看"默认MCP服务器"的状态应为"活动"，端口为10888 3. 查看演示服务器的端口分配（10889、10890） 4. 服务器URL应显示为对应的端口地址 ### 检查日志 在Odoo日志中查找以下信息： ``` INFO: 系统启动：开始自动启动活动的MCP服务器 INFO: 系统启动：已启动MCP服务器自动启动线程 INFO: 开始延迟自动启动MCP服务器 INFO: 找到 1 个活动状态的MCP服务器 INFO: 正在自动启动MCP服务器: 默认MCP服务器 (ID: 1) INFO: 开始异步启动MCP服务器: 默认MCP服务器 (端口: 10888) INFO: 成功自动启动MCP服务器: 默认MCP服务器 INFO: 系统启动：MCP服务器自动启动成功 INFO: FastMCP服务器已在 0.0.0.0:10888 启动 ``` ### 测试界面控制 1. **使用控制面板** - 导航到 **MCP服务器 > 控制面板** - 查看默认服务器卡片 - 如果显示"已停止"，点击"启动"按钮 - 等待状态变为"运行中" 2. **使用表单控制** - 打开"默认MCP服务器"表单 - 使用头部的控制按钮： - 点击"启动服务器"（如果未运行） - 点击"检查状态"查看详细信息 - 点击"测试连接"验证连接 3. **验证操作结果** - 成功操作会显示绿色通知 - 失败操作会显示红色错误通知 - 状态检查会显示详细的服务器信息 4. **验证自动启动** - 重启Odoo服务器 - 重新登录后检查服务器状态应为"运行中" - 点击"测试连接"应显示"连接成功"而不是"服务器已自动启动" ## 高级配置 ### 自定义端口 如果需要使用不同的端口，修改 `fast_mcp_service.py`： ```python # 在 _start_server_async 方法中 port = 10888 # 修改为所需端口 ``` ### 禁用自动启动 如果不希望某个服务器自动启动： 1. 将服务器状态设置为"草稿"或"不活动" 2. 重启Odoo后该服务器不会自动启动 ### 添加多个服务器 1. 创建新的MCP服务器记录 2. 设置状态为"活动" 3. 重启Odoo后会自动启动所有活动服务器 ## 生产环境部署 ### 安全配置 1. **API密钥管理** ```python # 每个服务器都有唯一的API密钥 # 在生产环境中应定期更换 ``` 2. **网络访问控制** ```python # 默认只监听本地接口 host = "127.0.0.1" # 生产环境建议保持此设置 ``` 3. **防火墙配置** ```bash # 如需外部访问，配置防火墙规则 ufw allow 10888/tcp ``` ### 性能优化 1. **数据库连接池** ```python # 在 SafeDatabaseManager 中调整连接池大小 pool_size = 20 # 根据负载调整 connection_timeout = 30 ``` 2. **异步处理** ```python # FastMCP服务使用独立的事件循环 # 不会阻塞Odoo主进程 ``` ### 监控和日志 1. **启用详细日志** ```python # 在odoo.conf中设置 log_level = info log_handler = :INFO ``` 2. **监控服务器状态** ```bash # 检查端口是否监听 netstat -tlnp | grep 10888 # 检查进程状态 ps aux | grep odoo ``` ## 故障排除 ### 常见问题 1. **端口被占用** ```bash # 检查端口占用 lsof -i :10888 # 终止占用进程 kill -9 <PID> ``` 2. **服务器未启动** - 检查服务器状态是否为"活动" - 查看Odoo错误日志 - 验证FastMCP依赖是否正确安装 3. **数据库连接问题** - 检查数据库配置 - 验证用户权限 - 查看数据库连接日志 ### 调试步骤 1. **检查模块安装** ```bash # 在Odoo中检查模块状态 # 应用 > 模块 > 搜索"MCP服务器" ``` 2. **手动启动测试** ```python # 在Odoo shell中测试 from odoo.addons.mcp_server.services.fast_mcp_service import FastMCPService service = FastMCPService.get_instance() service.auto_start_active_servers() ``` 3. **网络连接测试** ```bash # 测试本地连接 curl http://127.0.0.1:10888 # 测试端口响应 telnet 127.0.0.1 10888 ``` ## 升级指南 ### 从旧版本升级 1. **备份数据** ```bash pg_dump your_database > backup.sql ``` 2. **更新代码** ```bash # 替换模块文件 cp -r new_mcp_server /path/to/odoo/addons/ ``` 3. **升级模块** ```bash odoo-bin -u mcp_server -d your_database ``` 4. **验证升级** - 检查服务器是否自动启动 - 测试现有功能 - 查看升级日志 ### 配置迁移 升级后会自动： - 保留现有服务器配置 - 启动之前活动的服务器 - 更新资源定义 ## 支持和维护 ### 日常维护 1. **定期检查日志** 2. **监控服务器状态** 3. **更新API密钥** 4. **备份配置数据** ### 获取支持 - 查看项目文档 - 检查GitHub Issues - 联系技术支持 ## 版本信息 - **当前版本**: 1.0.0 - **Odoo版本**: 17.0+ - **Python版本**: 3.10+ - **更新日期**: 2025-07-22