Odoo Accounting MCP Server

🧾 Odoo Accounting MCP Server

Este é um servidor Model Context Protocol (MCP) simplificado, não pronto para produção, projetado para integração experimental com Odoo Accounting via XML-RPC. Especificamente adaptado para uso com Claude Desktop, este projeto foca em permitir que ferramentas de IA consultem e analisem lançamentos contábeis para fins de auditoria. Embora permita interação com dados contábeis do Odoo, seu escopo atual é limitado a esse caso de uso específico e não se destina a ambientes de produção. Explorações futuras podem considerar a expansão para outros dados relacionados à contabilidade, como faturas, dependendo dos resultados do foco inicial.

---

🔧 Exemplo: Claude Detectando Ferramenta MCP

🚀 Principais Recursos

• Conexão Segura com Odoo: Estabeleça uma conexão segura com sua instância Odoo usando variáveis de ambiente ou um arquivo de configuração dedicado.
• Ferramentas de Dados Contábeis: Fornece ferramentas especializadas para buscar e recuperar informações contábeis relevantes de forma eficiente.
• Pronto para Claude AI: Totalmente compatível com o Model Context Protocol, garantindo integração suave com o Claude Desktop.
• API RESTful (via FastAPI): Oferece um servidor FastAPI simples e robusto para expor endpoints RESTful.
• Configuração Flexível: Configure facilmente o servidor através das configurações do Claude Desktop.

---

🛠️ Guia de Configuração

Siga estas etapas para configurar e executar o Odoo Accounting MCP Server:

1. Clone o Repositório

git clone https://github.com/your-username/odoo-accounting-mcp.git
cd odoo-accounting-mcp

2. Configure as Variáveis de Ambiente

Crie um arquivo .env no diretório raiz do projeto e preencha-o com os detalhes da sua conexão Odoo:

ODOO_URL=http://localhost:8069
ODOO_DB=your_db_name
ODOO_USERNAME=your_odoo_user_name
ODOO_PASSWORD=your_odoo_password

3. Configure o Ambiente Virtual

Recomenda-se usar um ambiente virtual para gerenciar as dependências do projeto:

python -m venv .venv

Ative-o:

.\.venv\Scripts ctivate

4. Instale as Dependências

Instale os pacotes Python necessários do arquivo requirements.txt:

python -m pip install -r requirements.txt

5. Execute o Servidor

Inicie o servidor MCP usando o script Python principal:

python main.py

O servidor normalmente iniciará e estará acessível em http://localhost:8000.

---

⚙️ Integração com Claude Desktop

Você não precisa executar manualmente o servidor MCP ao usar o Claude Desktop. Em vez disso, configure o Claude Desktop para gerenciar o ciclo de vida do servidor.

Atualize seu arquivo claude_desktop_config.json com a seguinte configuração (ajuste os caminhos e as credenciais do Odoo conforme necessário):

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "cwd": "D:/jeevan-projects/odoomcp/odoo_account_mcp",
      "args": ["main.py"],
      "env": {
        "ODOO_URL": "http://localhost:8069",
        "ODOO_DB": "your_db",
        "ODOO_USERNAME": "admin",
        "ODOO_PASSWORD": "your_password"
      }
    }
  }
}

Notas Importantes:

• Garanta que o caminho cwd na configuração aponte para o diretório correto do seu projeto odoo_account_mcp.
• Substitua as credenciais Odoo de exemplo pelos detalhes reais da sua instância Odoo.