odoo-mcp

Odoo용 MCP 서버입니다. LLM 에이전트가 Odoo 인스턴스의 파트너, 판매 주문, 재고 수준 및 송장에 대한 읽기 및 쓰기 액세스를 제공합니다.

상태: 초기 단계입니다. 아래 도구 목록은 계획이며, 아직 모두 작동하지는 않습니다.

왜

Odoo는 광범위한 API를 갖춘 완전한 ERP로, 에이전트가 사용하기 어렵습니다. 외부 API는 XML-RPC이며 일반적인 search_read 및 execute_kw 호출을 사용하므로 에이전트는 모델 이름, 필드 이름 및 도메인 구문을 알아야 합니다. 이 서버는 대신 사람이 실제로 요청할 작업을 각각 다루는 소수의 명명된 도구를 노출합니다.

Odoo Community는 데모 데이터와 함께 Docker에서 실행되므로 실제 시스템 없이 전체를 시도할 수 있습니다.

Related MCP server: OdooSurface MCP

도구

빠른 시작

docker compose up -d odoo db    # Odoo Community with demo data
cp .env.example .env
docker compose up mcp

Odoo는 첫 시작 시 데이터베이스를 초기화하는 데 약 1분이 걸립니다.

작동 방식

서버는 XML-RPC를 통해 Odoo에 연결합니다. 각 도구는 도메인과 필드 목록을 자체적으로 구성하므로 에이전트는 Odoo 내부를 볼 수 없습니다. 결과는 중요한 필드로만 정리되어 평면 레코드로 반환됩니다.

설계 결정

일반 쿼리 도구가 아닌 명명된 도구. 단일 run_query 도구는 작성하기는 더 쉽지만 사용하기에는 훨씬 나쁩니다. 명명된 도구는 자체 검증을 수행하며 에이전트가 수행할 수 있는 작업을 명확하게 보여줍니다.

읽기와 쓰기는 분리됩니다. 쓰기 도구는 스키마에 표시되어 클라이언트가 확인을 요구할 수 있습니다.

오류는 변환됩니다. Odoo는 긴 추적과 함께 오류를 발생시킵니다. 서버는 메시지를 추출하여 에이전트가 조치할 수 있는 형태로 반환합니다.

아직 없는 것

• 페이지네이션 및 결과 제한

• 다중 회사 지원

• 시드된 Odoo 인스턴스에 대한 테스트

라이선스

MIT