Odoo 통합을 위한 모델 콘텍스 프로토콜 서버, AI 에이전트가 표준 인터페이스를 통해 Odoo 데이터에 액세스하고 조작할 수 있도록 합니다.

개요

MCP-Odoo는 모델 Context Protocol (MCP)을 사용하여 Odoo ERP 시스템과 AI 에이전트 사이의 브리지를 제공합니다. AI 시스템을 사용하여:

• 접속 파트너 정보
• 송장 및 결제를 포함한 회계 데이터보기 및 분석
• 금융기록의 재구성 수행
• Query 납품업자 청구서 및 고객 송장

특징

• Odoo 인스턴스와 쉽게 통합
• AI Agent 호환성을 위한 표준 MCP 공용영역
• Rich 리치 회계 데이터 액세스
• Odoo 보안 인증

설치

구성

.env] 를 생성한다. 프로젝트 루트에 다음 변수가 있다.

사용법

MCP 서버 시작:

문서

포괄적인 문서는 docs/ 디렉토리에 있습니다.

• Documentation Home - 모든 문서의 개요
• 구현 가이드 - 상세한 아키텍처 및 구현 세부
• 회계 기능 - 회계 기능에 대한 심층적 가이드
• 문제 해결 - 일반적인 문제에 대한 솔루션
• 사용 예제 - 시작하려면 실제 예제

MCP-Odoo

Model Context Protocol server for Odoo integration, allowing AI agents to access and manipulate Odoo data through a standardized interface.

Overview

MCP-Odoo provides a bridge between Odoo ERP systems and AI agents using the Model Context Protocol (MCP). This enables AI systems to:

• Access partner information
• View and analyze accounting data including invoices and payments
• Perform reconciliation of financial records
• Query vendor bills and customer invoices

Features

• 🔌 Easy integration with Odoo instances
• 🤖 Standard MCP interface for AI agent compatibility
• 📊 Rich accounting data access
• 🔒 Secure authentication with Odoo

Installation

# Clone the repository
git clone https://github.com/yourtechtribe/model-context-protocol-mcp-odoo.git
cd model-context-protocol-mcp-odoo

# Install dependencies
pip install -r requirements.txt

Configuration

Create a .env file in the project root with the following variables:

ODOO_URL=https://your-odoo-instance.com
ODOO_DB=your_database
ODOO_USERNAME=your_username
ODOO_PASSWORD=your_password
HOST=0.0.0.0
PORT=8080

Usage

Start the MCP server:

# Using the SSE transport (default)
python -m mcp_odoo_public

# Using stdio for local agent integration
python -m mcp_odoo_public --transport stdio

Documentation

Comprehensive documentation is available in the docs/ directory:

• Documentation Home - Start here for an overview of all documentation
• Implementation Guide - Detailed architecture and implementation details
• Accounting Functionality - In-depth guide to accounting features
• Troubleshooting - Solutions for common issues
• Usage Examples - Practical examples to get started

Development

Project Structure

• mcp_odoo_public/: Main package
  • odoo/: Odoo client and related modules
  • resources/: MCP resources definitions (tools and schemas)
  • server.py: MCP server implementation
  • config.py: Configuration management
  • mcp_instance.py: FastMCP instance definition

Adding New Resources

Resources define the capabilities exposed to AI agents through MCP. To add a new resource:

1. Create a new file in the resources/ directory
2. Define your resource using the @mcp.tool() decorator
3. Import your resource in resources/__init__.py

For detailed instructions, see the Implementation Guide.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Albert Gil López

• Email: [email protected]
• LinkedIn: https://www.linkedin.com/in/albertgilopez/

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.