Yt MCP Server Odoo

YT MCP Odoo服务器

Python MCP（模型上下文协议）客户端，使Claude、Cursor和VS Code Copilot等AI助手能够与您的Odoo ERP系统进行交互。

特性

• 🔍 搜索和阅读 -用自然语言查询任何Odoo模型
• ✏️ 创建和更新 -通过AI创建和修改记录
• 🗑️ 删除 -删除记录（具有适当权限）
• 📊 批量操作 -一次创建/更新多条记录
• 🔢 计数和浏览 -计数记录或按特定ID获取
• 📝 提示模板 -常见任务的预定义提示
• 🔐 安全 -具有Odoo用户权限的API密钥身份验证

安装

方案1：地方发展（推荐）

# Navigate to the mcp_client directory
cd /path/to/yt_mcp_server/mcp_client

# Install in development mode
pip install -e .

# Or using uv
uv pip install -e .

选项2：直接从路径

# Install directly from local path
pip install /path/to/yt_mcp_server/mcp_client

选项3：无需安装即可运行

# Run directly with Python
cd /path/to/yt_mcp_server/mcp_client
python -m yt_mcp_server_odoo

______________________________________________________________________

配置

环境变量

______________________________________________________________________

IDE安装指南

克劳德桌面版

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json\ 窗户： %APPDATA%\Claude\claude_desktop_config.json\ Linux： ~/.config/Claude/claude_desktop_config.json

选项A：使用已安装的软件包

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "yt_mcp_server_odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo.com",
        "ODOO_API_KEY": "your-api-key-here",
        "ODOO_DB": "your-database"
      }
    }
  }
}

选项B：直接使用本地路径

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["/path/to/yt_mcp_server/mcp_client/src/yt_mcp_server_odoo/__main__.py"],
      "env": {
        "ODOO_URL": "https://your-odoo.com",
        "ODOO_API_KEY": "your-api-key-here",
        "ODOO_DB": "your-database"
      }
    }
  }
}

光标

地点： ~/.cursor/mcp.json

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "yt_mcp_server_odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo.com",
        "ODOO_API_KEY": "your-api-key-here",
        "ODOO_DB": "your-database"
      }
    }
  }
}

VS代码（带副本/继续）

地点： .vscode/mcp.json 在您的工作区或 ~/.vscode/mcp.json 全球范围内

{
  "servers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "yt_mcp_server_odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo.com",
        "ODOO_API_KEY": "your-api-key-here",
        "ODOO_DB": "your-database"
      }
    }
  }
}

帆板运动

地点： ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "yt_mcp_server_odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo.com",
        "ODOO_API_KEY": "your-api-key-here",
        "ODOO_DB": "your-database"
      }
    }
  }
}

泽德

地点： ~/.config/zed/settings.json

{
  "context_servers": {
    "odoo": {
      "command": {
        "path": "python",
        "args": ["-m", "yt_mcp_server_odoo"],
        "env": {
          "ODOO_URL": "https://your-odoo.com",
          "ODOO_API_KEY": "your-api-key-here",
          "ODOO_DB": "your-database"
        }
      }
    }
  }
}

自定义/程序化

from yt_mcp_server_odoo import OdooMCPServer
from yt_mcp_server_odoo.config import OdooConfig

config = OdooConfig(
    odoo_url="https://your-odoo.com",
    odoo_api_key="your-api-key",
    odoo_db="your-database"
)

server = OdooMCPServer(config)
server.run()

______________________________________________________________________

可用的MCP工具

______________________________________________________________________

使用示例

配置后，询问您的AI助手：

"Show me all customers from Spain"
"Create a new contact named John Doe at Acme Corp"
"Find unpaid invoices from last month over $1000"
"Update the phone number for partner ID 42"
"How many products do we have in stock?"
"Delete the draft quotation SO0123"

______________________________________________________________________

YOLO模式（开发）

对于开发/测试，启用YOLO模式以绕过MCP模型限制：

{
  "env": {
    "ODOO_YOLO": "read"
  }
}

⚠️ 警告： YOLO模式绕过MCP限制，但仍然尊重Odoo用户权限。

______________________________________________________________________

获取API密钥

1. 首选 设置>MCP服务器 在奥多
2. 点击 管理API密钥
3. 为用户创建新的API密钥
4. 复制密钥（仅显示一次！）

______________________________________________________________________

故障排除

连接失败

• 检查 ODOO_URL 可访问
• 确保安装并启用了MCP服务器模块
• 验证API密钥是否有效

未找到型号

• 确保在中启用了模型 MCP服务器>已启用的型号
• 检查是否应启用YOLO模式进行开发

权限不足

• 验证API关键用户是否有权访问模型
• 检查模型权限（读/写/创建/删除）

______________________________________________________________________

许可证

LGPL-3.0