odoo-mcp

Odoo 19 JSON-2統合のためのDockerファーストなFastMCPサーバー。

このランタイムは、stdioとHTTPの両方のトランスポートで使用される共有サーバーファクトリを公開します。Odoo固有のツールは、odoo_mcp.tools.register_tools(server, config)または互換性のあるレジストリモジュールからそのファクトリに登録できます。

クイックスタート

1. 環境テンプレートをコピーします：

   cp .env.example .env

2. .envを編集して、Odooのエンドポイントと認証情報を設定します。

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