Odoo MCP Server

Um servidor MCP que fornece acesso direto às capacidades do sistema ERP Odoo.

GitHub
2
Experimente este MCPPatrocinado

Documentação

Odoo MCP Server

Um servidor Model Context Protocol (MCP) que fornece ao Claude acesso direto às capacidades do sistema ERP Odoo. Perfeito para empresas que usam Odoo para gerenciar suas operações por meio de interações em linguagem natural.

🚀 Recursos

📦 Gerenciamento de Inventário

  • Obter níveis atuais de inventário e informações de estoque
  • Pesquisar detalhes e especificações de produtos
  • Monitorar movimentações de estoque e disponibilidade
  • Criar ajustes de inventário (em breve)

🛒 Gerenciamento de Compras

  • Visualizar e filtrar ordens de compra por status
  • Obter informações de fornecedores/vendedores e contatos
  • Análises e relatórios de compras
  • Criar novas ordens de compra (versão simplificada)

🏭 Manufatura (MRP)

  • Visualizar ordens de manufatura e cronogramas de produção
  • Obter informações da Lista de Materiais (BOM)
  • Monitorar centros de trabalho e capacidade
  • Visão geral do planejamento de produção
  • Criar ordens de manufatura (versão simplificada)

🛠️ Instalação e Configuração

Pré-requisitos

  • Go 1.21 ou superior
  • Acesso a uma instância do Odoo 17
  • Banco de dados PostgreSQL (opcional para acesso direto ao banco)

1. Clonar e Compilar

git clone <repository-url>
cd odoo-mcp-server
go mod tidy
go build -o odoo-mcp-server

2. Configuração

Copie o exemplo de configuração e edite com os detalhes da sua conexão Odoo:

cp config.yaml.example config.yaml
vim config.yaml

A configuração deve conter:

odoo:
  url: "https://your-odoo-server.com"
  database: "your_database_name"
  username: "your_username"
  password: "your_password"

discord:
  webhook_url: "https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN"

webhook:
  port: "8080"
  enabled: true

3. Compilar Servidores

./build.sh

4. Testar Conexão

# Test MCP Server
./odoo-mcp-server

# Test Webhook Server (for Discord notifications)
./odoo-webhook-server

🎯 Uso com Claude (Cursor)

Configurar MCP no Cursor

Adicione às configurações do Cursor ou crie .cursor-mcp.json:

{
  "mcpServers": {
    "odoo": {
      "command": "/path/to/your/odoo-mcp-server",
      "args": [],
      "env": {}
    }
  }
}

Exemplos de Consultas

Gerenciamento de Inventário:

"Show me current inventory levels for all products"
"What's the stock level for product ABC123?"
"Get product information for knockdown houses"

Gerenciamento de Compras:

"Show me recent purchase orders"
"List all vendors/suppliers"
"Get purchase analytics for this month"
"Find vendor information for Company XYZ"

Manufatura:

"Show manufacturing orders in progress"
"Get BOM information for product DEF456"
"What's the current production planning?"
"Show me all work centers and their capacity"

🏗️ Ferramentas Disponíveis

Ferramentas de Inventário - Informações de produtos e estoque

  • get_inventory_levels - Ver níveis atuais de estoque
  • get_product_info - Informações detalhadas do produto
  • create_inventory_adjustment - Atualizar estoque (em desenvolvimento)

Ferramentas de Compras - Compras

  • get_purchase_orders - Ver ordens de compra
  • create_purchase_order - Criar nova ordem de compra
  • get_vendor_info - Informações de vendedores/fornecedores
  • get_purchase_analytics - Relatórios de compras

Ferramentas de MRP - Produção

  • get_manufacturing_orders - Ver ordens de produção
  • get_bom_info - Informações da Lista de Materiais
  • create_manufacturing_order - Criar ordem de produção
  • get_work_centers - Informações do centro de trabalho
  • get_production_planning - Plano de produção

🔧 Arquitetura

Claude (Cursor) ←→ MCP Protocol ←→ Go Server ←→ Odoo XML-RPC API
                                              ↓
                                         PostgreSQL DB

📊 Perfeito para Negócios de Montagem

Este servidor MCP é especialmente projetado para empresas que lidam com:

  • Casas/edifícios pré-fabricados (casas de montagem)
  • Móveis/armários pré-fabricados (armários de montagem)
  • Produtos de construção modular
  • Produtos que exigem montagem

Casos de Uso Empresariais

  • Planejamento de Inventário: "Quantas estruturas de casa de 3x4 metros temos em estoque?"
  • Planejamento de Compras: "Crie uma ordem de compra para ferragens de armário do Fornecedor ABC"
  • Agendamento de Produção: "Qual é o nosso cronograma de manufatura para a próxima semana?"
  • Gerenciamento de Fornecedores: "Mostre-me todos os fornecedores de componentes de aço"

🚦 Status e Roteiro

✅ Concluído

  • Implementação básica do protocolo MCP
  • Integração XML-RPC com Odoo
  • Ferramentas principais de inventário, compras e MRP
  • Gerenciamento de configuração
  • Tratamento de erros e registro de logs

🔄 Em Andamento

  • Listagem aprimorada de componentes da BOM
  • Fluxo completo de criação de ordens de compra
  • Criação completa de ordens de manufatura
  • Consultas diretas ao PostgreSQL para desempenho

📋 Planejado

  • Gerenciamento de ordens de venda
  • Integração contábil
  • Análises avançadas e painéis
  • Suporte a múltiplas empresas
  • Mapeamento de campos personalizados

🤝 Contribuindo

Sinta-se à vontade para contribuir! Este projeto foi projetado para ser uma integração abrangente do Odoo com MCP.

📝 Licença

Licença MIT - Use livremente para suas necessidades de automação empresarial!

Para o seu negócio - Do seu amigo programador! 🎪 # odoo-mcp-server