odoo-mcp

Odoo 19 JSON-2 통합을 위한 Docker 우선 FastMCP 서버입니다.

런타임은 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