sienge-ecbiesek-mcp 1.1.0__py3-none-any.whl → 1.1.1__py3-none-any.whl

sienge_ecbiesek_mcp-1.1.1.dist-info/METADATA

@@ -0,0 +1,383 @@
+Metadata-Version: 2.4
+Name: sienge-ecbiesek-mcp
+Version: 1.1.1
+Summary: Model Context Protocol (MCP) server for Sienge API integration - Brazilian construction management system
+Author-email: ECBIESEK <ti@ecbiesek.com>
+License: 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: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=0.1.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.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"
+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
+
+## 📦 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
+```
+
+### 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.8
+- fastmcp >= 2.12.3
+- httpx >= 0.25.0
+- pydantic >= 2.0.0
+- python-dotenv >= 1.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.1.0 (Atual)
+- ✅ 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.1.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+sienge_ecbiesek_mcp-1.1.1.dist-info/licenses/LICENSE,sha256=leWD46QLXsQ43M8fE_KgOo5Sf0YB9_X8EVqGdV0Dsc0,1101
+sienge_mcp/__init__.py,sha256=Pjl4hgBCWhVJ_BBZXaP7SuZfH7Z1JWZbSs8MV5sUle8,287
+sienge_mcp/server.py,sha256=-xMDp97XliIgJMii4X5Ws7gcHAT9Fwe3S2JViCd0tDs,43690
+sienge_mcp/utils/logger.py,sha256=bqU0GDsQXE9TaKOq5_6S2L8bh_Nas-EuYNDE3fzlPWg,5880
+sienge_ecbiesek_mcp-1.1.1.dist-info/METADATA,sha256=5jrtt8Q5SARdav4CAG7KPPcVLnTj4_fR6KwiTjDKzC8,11230
+sienge_ecbiesek_mcp-1.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+sienge_ecbiesek_mcp-1.1.1.dist-info/entry_points.txt,sha256=jxEu6gvTw3ci0mjDfqbi0rBLRpeuscwwRk9-H-UOnO8,63
+sienge_ecbiesek_mcp-1.1.1.dist-info/top_level.txt,sha256=FCvuhB9JQPKGY0Q8aKoVc7akqG5htoJyfj-eJvVUmWM,11
+sienge_ecbiesek_mcp-1.1.1.dist-info/RECORD,,

sienge_ecbiesek_mcp-1.1.0.dist-info/METADATA

@@ -1,34 +0,0 @@
-Metadata-Version: 2.4
-Name: sienge-ecbiesek-mcp
-Version: 1.1.0
-Summary: Sienge ECBIESEK MCP Server - Model Context Protocol integration for Sienge API (ECBIESEK Company)
-Author-email: ECBIESEK <ti@ecbiesek.com>
-License: MIT
-Project-URL: Homepage, https://github.com/Moizas951/Sienge-mcp
-Project-URL: Documentation, https://github.com/Moizas951/Sienge-mcp#readme
-Project-URL: Repository, https://github.com/Moizas951/Sienge-mcp.git
-Project-URL: Issues, https://github.com/Moizas951/Sienge-mcp/issues
-Keywords: sienge,mcp,claude,api,construction,ecbiesek
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-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
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: fastmcp>=0.1.0
-Requires-Dist: httpx>=0.25.0
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: python-dotenv>=1.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"
-Dynamic: license-file

sienge_ecbiesek_mcp-1.1.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-sienge_ecbiesek_mcp-1.1.0.dist-info/licenses/LICENSE,sha256=leWD46QLXsQ43M8fE_KgOo5Sf0YB9_X8EVqGdV0Dsc0,1101
-sienge_mcp/__init__.py,sha256=Pjl4hgBCWhVJ_BBZXaP7SuZfH7Z1JWZbSs8MV5sUle8,287
-sienge_mcp/server.py,sha256=-xMDp97XliIgJMii4X5Ws7gcHAT9Fwe3S2JViCd0tDs,43690
-sienge_mcp/utils/logger.py,sha256=bqU0GDsQXE9TaKOq5_6S2L8bh_Nas-EuYNDE3fzlPWg,5880
-sienge_ecbiesek_mcp-1.1.0.dist-info/METADATA,sha256=ayq0Ym2v-7Wik1FUnVvqflTNtz9TrccINRhAVPDpFT0,1534
-sienge_ecbiesek_mcp-1.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-sienge_ecbiesek_mcp-1.1.0.dist-info/entry_points.txt,sha256=jxEu6gvTw3ci0mjDfqbi0rBLRpeuscwwRk9-H-UOnO8,63
-sienge_ecbiesek_mcp-1.1.0.dist-info/top_level.txt,sha256=FCvuhB9JQPKGY0Q8aKoVc7akqG5htoJyfj-eJvVUmWM,11
-sienge_ecbiesek_mcp-1.1.0.dist-info/RECORD,,