Yt MCP Server Odoo

MCPAI代理

提供方 yugmatech

AI代理 stdio · 本地进程 无需鉴权 社区 / 第三方 ClaudeCursorWindsurfVS Code
查看接入方式

一个Python MCP客户端,使AI助手能够与Odoo ERP系统交互,支持搜索、创建、更新、删除记录等操作。

一句话选型结论

按资料字段整理

Yt MCP Server Odoo 属于AI代理类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude、Cursor、Windsurf 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 11 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量11暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Odoo集成Python本地部署AI助手ERP系统Python客户端模型交互

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install -e .

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 11 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 11 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor、Windsurf,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Yt MCP Server Odoo当前 11 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方yugmatech上游标注的维护方 yugmatech
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.5 KB
来自项目仓库与上游目录的原文,未做删改

YT MCP Odoo服务器

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

特性

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

安装

方案1:地方发展(推荐)```bash

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:直接从路径```bash
# Install directly from local path
pip install /path/to/yt_mcp_server/mcp_client

选项3:无需安装即可运行```bash

Run directly with Python

cd /path/to/yt_mcp_server/mcp_client
python -m yt_mcp_server_odoo


______________________________________________________________________

## 配置

### 环境变量

|变量|必填|默认|描述|
|----------|----------|---------|-------------|
| `ODOO_URL` |是的| `http://localhost:8069` |您的Odoo实例URL|
| `ODOO_API_KEY` |是|-|MCP服务器模块的API密钥|
| `ODOO_DB` |否|自动检测|数据库名称|
| `ODOO_USER` |否|-|用户名(API密钥的替代项)|
| `ODOO_PASSWORD` |否|-|密码(API密钥的替代项)|
| `MCP_TRANSPORT` |没有| `stdio` |运输: `stdio` 或 `streamable-http` |
| `MCP_HOST` |没有| `localhost` |HTTP传输主机|
| `MCP_PORT` |没有| `8000` |HTTP传输端口|
| `DEFAULT_LIMIT` |没有| `10` |每个查询的默认记录|
| `MAX_LIMIT` |没有| `100` |每次查询的最大记录数|
| `MAX_SMART_FIELDS` |没有| `25` |智能选择的最大字段数|
| `ODOO_YOLO` |没有| `off` |YOLO模式: `off`, `read`, `true` |

______________________________________________________________________

## IDE安装指南

### 克劳德桌面版

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

**选项A:使用已安装的软件包**```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"
}
}
}
}

选项B:直接使用本地路径```json
{
"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````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 全球范围内```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````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````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"
}
}
}
}
}


### 自定义/程序化```python
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工具

工具 说明
list_models 列出所有启用MCP的Odoo型号
search_records 使用域筛选器搜索记录
get_record 按ID获取单个记录
create_record 创建新记录
update_record 更新现有记录
delete_record 删除记录
count_records 统计与域匹配的记录
browse_records 按ID获取多条记录
create_bulk 一次创建多条记录
update_bulk 更新具有不同值的多个记录
list_prompts 列出可用的提示模板

使用示例

配置后,询问您的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模型限制:```json
{
"env": {
"ODOO_YOLO": "read"
}
}
模式 效果
off 正常-仅可访问配置的型号
read 无需MCP配置即可读取任何型号
true 完全访问所有型号(危险!)

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


获取API密钥

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

故障排除

连接失败

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

未找到型号

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

权限不足

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

许可证

LGPL-3.0

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Yt MCP Server Odoo 怎么安装?

在客户端按下面的安装命令接入:pip install -e .。装完在客户端配置里引用同一个包或端点。

Yt MCP Server Odoo 怎么在 Claude、Cursor、Windsurf 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Yt MCP Server Odoo 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Yt MCP Server Odoo 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Yt MCP Server Odoo 支持哪些客户端?

资料标注支持 Claude、Cursor、Windsurf、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Yt MCP Server Odoo 能提供哪些能力?

资料显示约 11 个工具;能力标签包括 模型交互、Python、Claude。具体工具清单以官方文档为准。

Yt MCP Server Odoo 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Yt MCP Server Odoo 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。