Odoo MCP Improved

Odoo MCP Improved

---

📋 Sumário

• Visão Geral
• Recursos
• Instalação
• Configuração
• Uso
• Referência de Ferramentas
• Referência de Recursos
• Prompts
• Integração com Claude Desktop
• Licença

---

🔍 Visão Geral

O Odoo MCP Improved é uma implementação abrangente do Model Context Protocol (MCP) para sistemas Odoo ERP. Ele fornece uma ponte entre modelos de linguagem de grande porte, como o Claude, e sua instância Odoo, permitindo que assistentes de IA interajam diretamente com seus dados e processos de negócios.

Esta versão estendida aprimora a implementação original do MCP-Odoo com ferramentas e recursos avançados para vendas, compras, gerenciamento de estoque e contabilidade, tornando-a uma solução poderosa para operações de negócios assistidas por IA.

---

✨ Recursos

Capacidades Principais

• Integração Perfeita com Odoo: Conecte-se diretamente à sua instância Odoo via XML-RPC
• Acesso Abrangente a Dados: Consulte e manipule dados em todos os módulos do Odoo
• Arquitetura Modular: Facilmente extensível com novas ferramentas e recursos
• Tratamento Robusto de Erros: Mensagens de erro claras e validação para operação confiável

Suporte a Domínios de Negócios

• Gerenciamento de Vendas: Rastreamento de pedidos, insights de clientes e análise de desempenho
• Gerenciamento de Compras: Gerenciamento de fornecedores, processamento de pedidos e métricas de desempenho
• Gerenciamento de Estoque: Monitoramento de estoque, ajustes de inventário e análise de rotatividade
• Contabilidade: Relatórios financeiros, lançamentos contábeis e análise de índices

Funcionalidades Avançadas

• Ferramentas Analíticas: Capacidades de inteligência de negócios em todos os domínios
• Prompts Especializados: Prompts pré-configurados para cenários de negócios comuns
• URIs de Recursos: Acesso padronizado a dados do Odoo por meio de padrões de URI
• Otimização de Desempenho: Cache e recuperação eficiente de dados

---

📦 Instalação

Usando pip

pip install odoo-mcp-improved

🚀 Uso

Executando o Servidor

# Using the module
python -m odoo_mcp

Exemplos de Interações

# Sales Analysis
Using the Odoo MCP, analyze our sales performance for the last quarter and identify our top-selling products.

# Inventory Check
Check the current stock levels for product XYZ across all warehouses.

# Financial Analysis
Calculate our current liquidity and profitability ratios based on the latest financial data.

# Customer Insights
Provide insights on customer ABC's purchase history and payment patterns.

---

🤖 Integração com Claude Desktop

Adicione o seguinte ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "odoo_mcp"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_DB": "your_database",
        "ODOO_USERNAME": "your_username",
        "ODOO_PASSWORD": "your_password"
      }
    }
  }
}

---

🛠️ Referência de Ferramentas

Ferramentas de Vendas

Ferramenta	Descrição
search_sales_orders	Pesquise pedidos de venda com filtragem avançada
create_sales_order	Crie um novo pedido de venda
analyze_sales_performance	Analise o desempenho de vendas por período, produto ou cliente
get_customer_insights	Obtenha insights detalhados sobre um cliente específico

Ferramentas de Compras

Ferramenta	Descrição
search_purchase_orders	Pesquise pedidos de compra com filtragem avançada
create_purchase_order	Crie um novo pedido de compra
analyze_supplier_performance	Analise métricas de desempenho de fornecedores

Ferramentas de Estoque

Ferramenta	Descrição
check_product_availability	Verifique a disponibilidade de estoque para produtos
create_inventory_adjustment	Crie lançamentos de ajuste de inventário
analyze_inventory_turnover	Calcule e analise métricas de rotatividade de estoque

Ferramentas de Contabilidade

Ferramenta	Descrição
search_journal_entries	Pesquise lançamentos contábeis
create_journal_entry	Crie um novo lançamento contábil
analyze_financial_ratios	Calcule os principais índices financeiros

---

🔗 Referência de Recursos

Recursos de Vendas

URI	Descrição
odoo://sales/orders	Liste pedidos de venda
odoo://sales/order/{order_id}	Obtenha detalhes de um pedido de venda específico
odoo://sales/products	Liste produtos vendáveis
odoo://sales/customers	Liste clientes

Recursos de Compras

URI	Descrição
odoo://purchase/orders	Liste pedidos de compra
odoo://purchase/order/{order_id}	Obtenha detalhes de um pedido de compra específico
odoo://purchase/suppliers	Liste fornecedores

Recursos de Estoque

URI	Descrição
odoo://inventory/products	Liste produtos no inventário
odoo://inventory/stock/{location_id}	Obtenha níveis de estoque em um local específico
odoo://inventory/movements	Liste movimentações de inventário

Recursos de Contabilidade

URI	Descrição
odoo://accounting/accounts	Liste contas contábeis
odoo://accounting/journal_entries	Liste lançamentos contábeis
odoo://accounting/reports/{report_type}	Obtenha relatórios financeiros

---

💬 Prompts

O Odoo MCP Improved inclui prompts especializados para diferentes cenários de negócios:

Prompts de Análise de Vendas

• Análise de tendências de vendas
• Segmentação de clientes
• Avaliação de desempenho de produtos
• Desempenho da equipe de vendas

Prompts de Gerenciamento de Estoque

• Otimização de estoque
• Sugestões de reabastecimento
• Análise de eficiência do armazém
• Padrões de movimentação de produtos

Prompts de Recursos Humanos

• Planejamento de equipe
• Otimização de agendamento
• Avaliação de desempenho
• Alocação de recursos

Prompts de Análise Financeira

• Interpretação de índices
• Análise de fluxo de caixa
• Análise de variação orçamentária
• Avaliação de saúde financeira

---

📄 Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Este repositório é uma extensão de mcp-odoo - Lê Anh Tuấn

---