关于 Odoo MCP Server
Odoo MCP Server 通过 JSON-RPC 连接 Odoo 18.0，并通过 Odoo Extract API 进行 OCR。它支持读取和修改模型记录，以及提交文档进行解析。
主要功能
- 01查看可用模型和字段
- 02搜索并读取记录
- 03创建、更新和删除记录
- 04提交文档进行 OCR 解析
- 05获取解析结果
适用场景
- 01查询前检查 Odoo 模型结构
- 02查找并更新合作伙伴记录
- 03创建或删除 Odoo 记录
- 04从文档中提取发票数据
MCP 相关
向 MCP 客户端提供 Odoo 模型查询、记录操作和文档解析工具。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
暂未收录安装方式
我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。
详细介绍
Odoo MCP 服务
安全、便捷地访问 Odoo 18.0（JSON-RPC）和用于 OCR 文档解析的 Odoo Extract API。
🚀 使用 Cline 快速开始
-
克隆仓库：
git clone https://github.com/onlybets/odoo-mcp-server-unofficial.git cd odoo-mcp-server-unofficial -
配置凭据：
cp .env.example .env # Edit .env and fill in your Odoo/Extract credentials -
使用 Cline 运行（无需自托管）：
- Cline 会自动在本地为你运行服务。
- 只需在 Cline 中打开仓库，即可开始使用这些工具！
🛠️ 工具和 JSON 架构
1. list_models
返回当前用户可见的模型。
输入： 无
输出：
[
{"model": "res.partner", "name": "Contact"},
{"model": "crm.lead", "name": "Lead"}
]
2. get_fields
返回模型的字段和元数据。
输入：
{ "model": "res.partner" }
输出：
{
"id": {"string": "ID", "type": "integer", "required": true, "readonly": true},
"name": {"string": "Name", "type": "char", "required": true, "readonly": false}
}
3. search_read
搜索并读取模型中的记录。
输入：
{
"model": "res.partner",
"domain": [["is_company", "=", true]],
"fields": ["id", "name", "email"],
"limit": 10
}
输出：
[
{"id": 7, "name": "Acme Corp", "email": "[email protected]"}
]
4. create_record
在模型中创建一条新记录。
输入：
{
"model": "res.partner",
"values": {"name": "New Partner", "email": "[email protected]"}
}
输出：
{ "id": 42 }
5. update_record
更新模型中的一条或多条记录。
输入：
{
"model": "res.partner",
"ids": [42],
"values": {"email": "[email protected]"}
}
输出：
{ "success": true }
6. delete_record
删除模型中的一条或多条记录。
输入：
{
"model": "res.partner",
"ids": [42]
}
输出：
{ "success": true }
7. extract_parse
启动文档提取任务。
输入：
{
"document_base64": "<base64-encoded-pdf>",
"doc_type": "invoice",
"version": "18.0"
}
输出：
{ "document_token": "abc123", "status": "processing" }
8. extract_get_result
获取文档提取任务的结果。
输入：
{
"doc_type": "invoice",
"version": "18.0",
"document_token": "abc123"
}
输出：
{
"status": "done",
"data": { "invoice_number": "INV-001", "total": 123.45 }
}
🐳 Docker Compose
- 运行所有服务：
docker-compose up --build - 开箱即用，适用于本地开发和测试。
🧪 CI/CD
- GitHub Actions 工作流（
.github/workflows/ci.yml）会运行：pylint（如果可用，则使用 odoo 插件）pytest（运行冒烟测试）
- 使用 Python 3.11 及更高版本的矩阵。
📄 许可证
MIT 许可证。请参阅 LICENSE。
MCP 服务 — Model Context Protocol
https://modelcontextprotocol.org/
评论
支持 Markdown
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。