sienge-ecbiesek-mcp 1.5.2__tar.gz

sienge_ecbiesek_mcp-1.5.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sienge MCP Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sienge_ecbiesek_mcp-1.5.2/MANIFEST.in

@@ -0,0 +1,12 @@
+include README.md
+include LICENSE
+include COMO_TESTAR.md
+include GUIA_ATUALIZACAO.md
+include PUBLICADO_PYPI.md
+include requirements.txt
+include claude_desktop_config.template.json
+recursive-include src/sienge_mcp *.py *.json *.md *.txt
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+recursive-exclude * .DS_Store
+recursive-exclude * Thumbs.db

sienge_ecbiesek_mcp-1.5.2/PKG-INFO

@@ -0,0 +1,415 @@
+Metadata-Version: 2.4
+Name: sienge-ecbiesek-mcp
+Version: 1.5.2
+Summary: 🏗️ Model Context Protocol (MCP) server for Sienge API integration - Brazilian construction ERP system. Connect Claude AI to Sienge with 50+ powerful tools for comprehensive business management including financials, projects, operations, and Supabase database queries.
+Author-email: ECBIESEK <ti@ecbiesek.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/INOTECH-ecbiesek/Sienge-MCP
+Project-URL: Documentation, https://github.com/INOTECH-ecbiesek/Sienge-MCP#readme
+Project-URL: Repository, https://github.com/INOTECH-ecbiesek/Sienge-MCP.git
+Project-URL: Issues, https://github.com/INOTECH-ecbiesek/Sienge-MCP/issues
+Project-URL: Bug Reports, https://github.com/INOTECH-ecbiesek/Sienge-MCP/issues
+Project-URL: Source Code, https://github.com/INOTECH-ecbiesek/Sienge-MCP
+Project-URL: PyPI, https://pypi.org/project/sienge-ecbiesek-mcp/
+Keywords: sienge,mcp,model-context-protocol,claude,api,construction,erp,brazil,ecbiesek,fastmcp,ai-integration
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Scientific/Engineering :: Interface Engine/Protocol Translator
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Environment :: Console
+Classifier: Framework :: FastAPI
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=2.12.3
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: supabase>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: toml>=0.10.2; extra == "dev"
+Dynamic: license-file
+
+# Sienge MCP Server
+
+Um servidor Model Context Protocol (MCP) para integração com a API do Sienge, sistema de gestão para empresas de construção civil.
+
+## 🚀 Funcionalidades
+
+### 📊 Contas a Receber
+- **get_sienge_accounts_receivable**: Lista contas a receber com filtros por período
+- Utiliza a Bulk-data API do Sienge para consultas eficientes
+- Suporte a filtros por data de vencimento e data de competência
+
+### 🏢 Projetos e Empresas
+- **get_sienge_projects**: Lista todos os projetos/empresas disponíveis
+- Informações detalhadas incluindo ID, nome, endereço e status
+
+### 📝 Notas Fiscais de Compra
+- **get_sienge_purchase_invoices**: Lista todas as notas fiscais de compra
+- **get_sienge_purchase_invoice_details**: Detalhes completos de uma nota fiscal específica
+- **get_sienge_purchase_invoice_items**: Lista itens de uma nota fiscal
+- **get_sienge_purchase_invoice_payments**: Lista pagamentos de uma nota fiscal
+- **search_sienge_purchase_invoices**: Busca avançada com múltiplos filtros
+
+### 🔍 Solicitações de Compra
+- **get_sienge_purchase_requests**: Lista solicitações de compra do sistema
+
+### 🗄️ Consultas Supabase
+- **query_supabase_database**: Executa queries no banco de dados Supabase
+- **get_supabase_table_info**: Obtém informações sobre tabelas disponíveis
+- **search_supabase_data**: Busca universal em múltiplas tabelas
+- Suporte a filtros, ordenação e busca textual/inteligente
+- Schema fixo `sienge_data` para organização dos dados
+
+### 🔍 Busca Universal
+- **search_sienge_data**: Busca unificada em múltiplas entidades do Sienge
+- **search_sienge_financial_data**: Busca avançada em dados financeiros
+- **get_sienge_data_paginated**: Paginação avançada para grandes volumes
+- **get_sienge_dashboard_summary**: Resumo executivo do sistema
+
+## 📦 Instalação
+
+### Via PyPI (Recomendado)
+```bash
+pip install sienge-ecbiesek-mcp
+```
+
+### Via Código Fonte
+```bash
+git clone https://github.com/INOTECH-ecbiesek/Sienge-MCP.git
+cd Sienge-MCP
+pip install -e .
+```
+
+## ⚙️ Configuração
+
+### 1. Variáveis de Ambiente
+Crie um arquivo `.env` no diretório do projeto com as seguintes variáveis:
+
+```env
+# Configurações da API do Sienge
+SIENGE_BASE_URL=https://api.sienge.com.br
+SIENGE_SUBDOMAIN=seu_subdominio
+SIENGE_USERNAME=seu_usuario
+SIENGE_PASSWORD=sua_senha
+SIENGE_TIMEOUT=30
+
+# Configurações do Supabase (opcional)
+SUPABASE_URL=https://seu-projeto.supabase.co
+SUPABASE_SERVICE_ROLE_KEY=sua_service_role_key
+```
+
+### 2. Configuração no Claude Desktop
+
+#### Configuração Básica
+Adicione ao seu arquivo de configuração do Claude Desktop (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "sienge-mcp": {
+      "command": "python",
+      "args": ["-m", "sienge_mcp"],
+      "env": {
+        "SIENGE_BASE_URL": "https://api.sienge.com.br",
+        "SIENGE_SUBDOMAIN": "seu_subdominio",
+        "SIENGE_USERNAME": "seu_usuario",
+        "SIENGE_PASSWORD": "sua_senha",
+        "SIENGE_TIMEOUT": "30"
+      }
+    }
+  }
+}
+```
+
+#### Configuração com Virtual Environment
+Se você estiver usando um ambiente virtual:
+
+```json
+{
+  "mcpServers": {
+    "sienge-mcp": {
+      "command": "C:/caminho/para/seu/venv/Scripts/python.exe",
+      "args": ["-m", "sienge_mcp"],
+      "env": {
+        "SIENGE_BASE_URL": "https://api.sienge.com.br",
+        "SIENGE_SUBDOMAIN": "seu_subdominio",
+        "SIENGE_USERNAME": "seu_usuario",
+        "SIENGE_PASSWORD": "sua_senha",
+        "SIENGE_TIMEOUT": "30"
+      }
+    }
+  }
+}
+```
+
+## 🔐 Autenticação
+
+### Credenciais do Sienge
+A autenticação é feita através de **usuário e senha** do Sienge, não por token API:
+
+1. **SIENGE_BASE_URL**: URL base da API (`https://api.sienge.com.br`)
+2. **SIENGE_SUBDOMAIN**: Seu subdomínio no Sienge (ex: `suaempresa`)
+3. **SIENGE_USERNAME**: Seu nome de usuário no Sienge
+4. **SIENGE_PASSWORD**: Sua senha no Sienge
+5. **SIENGE_TIMEOUT**: Timeout das requisições em segundos (padrão: 30)
+
+### URLs da API
+- **API Base**: `https://api.sienge.com.br`
+- **Endpoints v1**: `/sienge/api/public/v1/`
+- **Bulk-data API**: `/bulk-data/`
+
+## 💻 Como Usar
+
+### 1. Iniciando o Servidor
+```bash
+# Via módulo Python
+python -m sienge_mcp
+
+# Ou diretamente
+sienge-mcp-server
+```
+
+### 2. No Claude Desktop
+Após configurar o servidor, reinicie o Claude Desktop. O servidor MCP será automaticamente carregado e as ferramentas ficarão disponíveis.
+
+### 3. Exemplos de Uso no Claude
+
+#### Consultar Contas a Receber
+```
+"Liste as contas a receber com vencimento entre 01/01/2024 e 31/01/2024"
+```
+
+#### Buscar Projetos
+```
+"Mostre todos os projetos disponíveis no Sienge"
+```
+
+#### Consultar Notas Fiscais
+```
+"Liste as notas fiscais de compra do mês atual"
+```
+
+#### Busca Avançada de Notas Fiscais
+```
+"Busque notas fiscais de compra com valor acima de R$ 10.000,00 emitidas em dezembro de 2023"
+```
+
+## 🛠️ Desenvolvimento
+
+### Estrutura do Projeto
+```
+src/
+├── sienge_mcp/
+│   ├── __init__.py
+│   ├── server.py          # Servidor MCP principal
+│   ├── services/          # Serviços de integração
+│   ├── tools/             # Ferramentas MCP
+│   └── utils/
+│       └── logger.py      # Sistema de logging
+```
+
+### Executando em Modo de Desenvolvimento
+```bash
+# Clone o repositório
+git clone https://github.com/INOTECH-ecbiesek/Sienge-MCP.git
+cd Sienge-MCP
+
+# Crie um ambiente virtual
+python -m venv .venv
+.venv\Scripts\activate  # Windows
+source .venv/bin/activate  # Linux/Mac
+
+# Instale as dependências
+pip install -e .
+
+# Configure as variáveis de ambiente
+cp .env.example .env
+# Edite o arquivo .env com suas configurações
+
+# Execute o servidor
+python -m sienge_mcp
+```
+
+### Testando Localmente
+```bash
+# Instale as dependências de teste
+pip install pytest pytest-asyncio
+
+# Execute os testes
+pytest tests/
+```
+
+## 📋 Requisitos
+
+### Dependências
+- Python >= 3.10
+- fastmcp >= 2.12.3
+- httpx >= 0.25.0
+- pydantic >= 2.0.0
+- python-dotenv >= 1.0.0
+- supabase >= 2.0.0
+
+### Compatibilidade
+- ✅ Windows
+- ✅ macOS  
+- ✅ Linux
+- ✅ Claude Desktop
+- ✅ Outros clientes MCP
+
+## 🔧 Configurações Avançadas
+
+### Logs e Debug
+O servidor inclui sistema de logging configurável:
+
+```python
+# Nível de log via variável de ambiente
+LOG_LEVEL=DEBUG  # DEBUG, INFO, WARNING, ERROR
+```
+
+### Timeout de Requisições
+Configure o timeout das requisições HTTP:
+
+```python
+# Timeout em segundos (padrão: 30s)
+SIENGE_TIMEOUT=60
+```
+
+### Cache de Respostas
+Para melhor performance em consultas frequentes:
+
+```python
+# Habilitar cache (padrão: False)
+SIENGE_CACHE_ENABLED=true
+SIENGE_CACHE_TTL=300  # TTL em segundos
+```
+
+## 🚨 Solução de Problemas
+
+### Erros Comuns
+
+#### Erro 401 - Unauthorized
+```
+Causa: Credenciais inválidas (usuário/senha incorretos)
+Solução: Verifique seu usuário e senha no Sienge
+```
+
+#### Erro 404 - Not Found
+```
+Causa: Endpoint incorreto ou recurso não encontrado
+Solução: Verifique as URLs base da API
+```
+
+#### Erro 429 - Rate Limited
+```
+Causa: Muitas requisições por minuto
+Solução: Implemente delay entre requisições
+```
+
+#### Servidor MCP não conecta
+```
+1. Verifique se o Python está no PATH
+2. Confirme se o módulo está instalado: pip show sienge-ecbiesek-mcp
+3. Teste a execução manual: python -m sienge_mcp
+4. Verifique os logs do Claude Desktop
+```
+
+### Debug
+Para debugar problemas de conexão:
+
+```bash
+# Execute com logs detalhados
+LOG_LEVEL=DEBUG python -m sienge_mcp
+
+# Teste a conectividade com a API
+# Use as credenciais do seu arquivo de configuração para testar
+```
+
+## 📚 Documentação da API
+
+### Endpoints Utilizados
+
+#### API Padrão (v1)
+- `GET /enterprises` - Lista empresas/projetos
+- `GET /purchase-requests` - Solicitações de compra  
+- `GET /purchase-invoices` - Notas fiscais de compra
+- `GET /purchase-invoices/{id}` - Detalhes da nota fiscal
+- `GET /purchase-invoices/{id}/items` - Itens da nota fiscal
+- `GET /purchase-invoices/{id}/payments` - Pagamentos da nota fiscal
+
+#### Bulk-data API
+- `POST /income` - Contas a receber (bulk)
+
+### Formatos de Data
+- **ISO 8601**: `2024-01-01T00:00:00Z`
+- **Brasileiro**: `01/01/2024`
+- **Filtros de período**: `start_date` e `end_date`
+
+### Códigos de Status
+- `200` - Sucesso
+- `400` - Requisição inválida
+- `401` - Não autorizado
+- `404` - Recurso não encontrado
+- `429` - Rate limit excedido
+- `500` - Erro interno do servidor
+
+## 📄 Licença
+
+Este projeto está licenciado sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.
+
+## 🤝 Contribuindo
+
+1. Faça um fork do projeto
+2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)
+3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)
+4. Push para a branch (`git push origin feature/AmazingFeature`)
+5. Abra um Pull Request
+
+## 📞 Suporte
+
+- **Issues**: [GitHub Issues](https://github.com/INOTECH-ecbiesek/Sienge-MCP/issues)
+- **Documentação**: [Wiki do Projeto](https://github.com/INOTECH-ecbiesek/Sienge-MCP/wiki)
+- **API Sienge**: [Documentação Oficial](https://api.sienge.com.br/docs)
+
+## 📈 Versões
+
+### v1.3.0 (Atual)
+- ✅ **NOVO**: Integração completa com Supabase
+- ✅ **NOVO**: 3 ferramentas de consulta ao banco de dados
+- ✅ **NOVO**: Busca universal em múltiplas tabelas
+- ✅ **NOVO**: Busca inteligente (textual + numérica)
+- ✅ **NOVO**: Dashboard executivo do sistema
+- ✅ **NOVO**: Paginação avançada para grandes volumes
+- ✅ **NOVO**: Busca financeira unificada
+- ✅ **MELHORADO**: Validação de parâmetros robusta
+- ✅ **MELHORADO**: Tratamento de erros aprimorado
+- ✅ **MELHORADO**: Documentação completa atualizada
+
+### v1.2.3
+- ✅ Adicionadas 5 ferramentas para Notas Fiscais de Compra
+- ✅ Suporte à Bulk-data API para contas a receber
+- ✅ Correção de endpoints para projetos/empresas
+- ✅ Melhorias na documentação e tratamento de erros
+
+### v1.0.0
+- ✅ Versão inicial com ferramentas básicas
+- ✅ Integração com API padrão do Sienge
+- ✅ Suporte a contas a receber, projetos e solicitações de compra
+
+---
+
+**Desenvolvido por INOTECH-ecbiesek** 🚀

sienge_ecbiesek_mcp-1.5.2/PUBLICADO_PYPI.md

@@ -0,0 +1,110 @@
+# 🎉 SIENGE ECBIESEK MCP - VERSÃO 1.2.0 PUBLICADA!
+
+## ✅ **NOVA VERSÃO MAJOR LANÇADA!**
+
+**URL PyPI**: https://pypi.org/project/sienge-ecbiesek-mcp/1.2.0/
+
+### 🚀 **NOVIDADES DA VERSÃO 1.2.0:**
+- ✅ **50+ tools** para gestão completa do Sienge
+- ✅ **Bulk data polling** para grandes volumes
+- ✅ **Cache inteligente** para performance
+- ✅ **Normalização automática** de payloads
+- ✅ **Observabilidade completa** com logs e métricas
+- ✅ **Aliases de compatibilidade** para todas as funções
+- ✅ **Mascaramento de dados** sensíveis
+- ✅ **Paginação avançada** com metadados corretos
+
+---
+
+## 🚀 **INSTALAÇÃO PARA USUÁRIOS**
+
+### **Opção 1: Execução Direta (Recomendada)**
+```bash
+pipx run sienge-ecbiesek-mcp@latest
+```
+
+### **Opção 2: Instalação Permanente**
+```bash
+pip install sienge-ecbiesek-mcp
+sienge-ecbiesek-mcp
+```
+
+---
+
+## ⚙️ **CONFIGURAÇÃO CLAUDE DESKTOP**
+
+Agora **qualquer funcionário da ECBIESEK** pode usar esta configuração:
+
+```json
+{
+  "mcpServers": {
+    "SiengeECBIESEK": {
+      "command": "pipx",
+      "args": [
+        "run",
+        "sienge-ecbiesek-mcp@latest"
+      ],
+      "env": {
+        "SIENGE_BASE_URL": "https://api.sienge.com.br",
+        "SIENGE_SUBDOMAIN": "ecbiesek",
+        "SIENGE_USERNAME": "usuario_ecbiesek",
+        "SIENGE_PASSWORD": "senha_ecbiesek"
+      }
+    }
+  }
+}
+```
+
+---
+
+## 🎯 **COMO USAR (EQUIPE ECBIESEK)**
+
+### **1. Instalar pipx** (se não tiver):
+```bash
+pip install pipx
+```
+
+### **2. Configurar Claude Desktop**:
+- Editar: `%APPDATA%\Claude\claude_desktop_config.json`
+- Colar a configuração acima
+- Substituir credenciais reais
+
+### **3. Reiniciar Claude Desktop**
+
+### **4. Testar**:
+- "Liste os projetos da ECBIESEK"
+- "Mostre as contas a pagar em aberto"
+- "Quais colaboradores temos cadastrados?"
+
+---
+
+## 🏆 **CONQUISTAS ALCANÇADAS**
+
+✅ **Package personalizado** para ECBIESEK  
+✅ **Publicado no PyPI** mundialmente  
+✅ **Instalação ultra-simples** via pipx  
+✅ **Configuração pré-definida** para ECBIESEK  
+✅ **30+ ferramentas** do Sienge disponíveis  
+✅ **Funciona igual ao ClickUp MCP**  
+
+---
+
+## 📤 **DISTRIBUIÇÃO PARA A EQUIPE**
+
+Compartilhe esta configuração com sua equipe:
+
+**Arquivo**: `claude_desktop_config.json`
+**Localização**: `%APPDATA%\Claude\`
+**Credenciais**: Cada usuário coloca suas próprias
+
+---
+
+## 🎉 **MISSÃO CUMPRIDA!**
+
+O **Sienge ECBIESEK MCP** está agora:
+- ✅ **Publicado no PyPI**
+- ✅ **Disponível globalmente**
+- ✅ **Pronto para uso da equipe**
+- ✅ **Funciona como ClickUp MCP**
+
+**Sua empresa agora tem um MCP profissional e distribuível!** 🏢✨