Sobre o projeto

Este repositório fornece um ecossistema de clientes multi-idioma para a API do Katana Manufacturing ERP, incluindo clientes Python e TypeScript, além de um servidor alfa do Model Context Protocol (MCP). Todos os clientes são gerados a partir de uma especificação OpenAPI 3.1.0 e possuem novas tentativas automáticas, tratamento de limite de taxa e paginação inteligente. O cliente Python suporta operações síncronas e assíncronas com segurança de tipos completa via Pydantic, enquanto o cliente TypeScript é somente assíncrono, com segurança de tipos completa e suporte a navegadores. O servidor MCP envolve um subconjunto selecionado de ferramentas de alto nível (pesquisar, modificar, cumprir, verificar) e inclui pares de pré-visualização/aplicação para operações de escrita, permitindo integração com assistentes de IA como Claude e Cursor. A configuração é flexível por meio de variáveis de ambiente, arquivos .env ou parâmetros diretos. O projeto é estruturado como um monorepo com documentação compartilhada, registros de decisão de arquitetura e um sistema de build unificado usando uv. O desenvolvimento inclui hooks de pré-commit, commits convencionais para lançamentos automatizados e testes abrangentes.