odoo-mcp

面向 Docker 的 FastMCP 服务器，用于 Odoo 19 JSON-2 集成。

该运行时公开了一个共享服务器工厂，可同时用于 stdio 和 HTTP 传输。Odoo 特定的工具可以通过 odoo_mcp.tools.register_tools(server, config) 或兼容的注册模块在该工厂中进行注册。

快速开始

1. 复制环境变量模板：

   cp .env.example .env

2. 使用您的 Odoo 端点和凭据编辑 .env 文件。

3. 启动 HTTP 服务器：

   docker compose up --build

4. 检查本地就绪状态：

   docker compose exec odoo-mcp uv run --no-sync odoo-mcp healthcheck

默认的 MCP 端点为 http://localhost:8000/mcp。

Related MCP server: MCP Odoo Bridge Server

运行时命令

对于直接启动服务器进程的 MCP 客户端，通过 stdio 运行：

odoo-mcp stdio

通过 HTTP 运行：

odoo-mcp http --host 0.0.0.0 --port 8000 --path /mcp

检查已脱敏的配置，而不暴露密钥：

odoo-mcp inspect-config

检查本地进程就绪状态，而不联系 Odoo：

odoo-mcp healthcheck

配置

开发

使用 uv 安装并运行测试：

uv sync
uv run pytest

CI 使用的静态检查：

uv run ruff check .
uv run mypy

Docker 是目标部署路径，但单元测试不需要本地 Docker。Docker 健康检查使用 odoo-mcp healthcheck，它在不进行外部网络调用的情况下验证服务器进程的连接情况。

集成点

共享工厂为 odoo_mcp.server.build_server()。它始终注册一个本地 healthcheck 工具，然后尝试从以下位置导入工具注册：

• odoo_mcp.tools.register_tools

• odoo_mcp.tools.registry.register_tools

• odoo_mcp.tools.odoo.register_tools

兼容的函数可以接受 (server) 或 (server, config)。这旨在让 Odoo 客户端、模式和工具工作者能够独立部署，而无需更改运行时入口点。

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• healthcheckA