3.3 KiB
3.3 KiB
05 - Script de Inicialização Rápida
🎯 Objetivo
Gerar o arquivo run.sh que automatiza a inicialização do sistema MCP.
📋 Contexto
O script bash facilita a execução do projeto, verificando dependências e ativando o ambiente virtual automaticamente.
🔧 Especificações Técnicas
- Linguagem: Bash script
- Funcionalidades: Verificação de ambiente, instalação de deps, execução
- Permissões: Executável (chmod +x)
💬 PROMPT COMPLETO
Crie um script bash chamado "run.sh" para iniciar um projeto Python MCP.
REQUISITOS:
1. CABEÇALHO:
- Shebang: #!/bin/bash
- Comentário descritivo
2. BANNER INICIAL:
Imprimir:
========================================== Sistema MCP - Operações Matemáticas
3. VERIFICAÇÕES:
- Verificar se diretório "venv" existe
- Se não existir, imprimir erro e instruções
- Exit code 1 se falhar
4. ATIVAÇÃO DO AMBIENTE VIRTUAL:
- source venv/bin/activate
5. VERIFICAÇÃO DE DEPENDÊNCIAS:
- Tentar importar módulo "mcp" em Python
- Se falhar, instalar dependências: pip install -r requirements.txt
6. EXECUÇÃO:
- Imprimir "🚀 Iniciando cliente MCP..."
- Executar: python mcp_client.py
FORMATO DE MENSAGENS:
- Usar emojis: ❌ para erro, 📦 para instalação, 🚀 para execução
- Linhas em branco para separação visual
EXEMPLO DE VERIFICAÇÃO:
```bash
if [ ! -d "venv" ]; then
echo "❌ Ambiente virtual não encontrado!"
echo " Execute: python3.11 -m venv venv"
exit 1
fi
Por favor, gere o script bash completo seguindo estas especificações.
---
## ✅ Resultado Esperado
Você deve receber um script bash (~25 linhas):
```bash
#!/bin/bash
# Script de inicialização rápida do sistema MCP
echo "=========================================="
echo " Sistema MCP - Operações Matemáticas"
echo "=========================================="
echo ""
# Verificar se ambiente virtual existe
if [ ! -d "venv" ]; then
echo "❌ Ambiente virtual não encontrado!"
echo " Execute: python3.11 -m venv venv"
exit 1
fi
# Ativar ambiente virtual
source venv/bin/activate
# Verificar se dependências estão instaladas
if ! python -c "import mcp" 2>/dev/null; then
echo "📦 Instalando dependências..."
pip install -r requirements.txt
echo ""
fi
# Executar cliente MCP
echo "🚀 Iniciando cliente MCP..."
echo ""
python mcp_client.py
🧪 Como Validar
Salve o script em mcp_project/run.sh e execute:
# 1. Tornar executável
chmod +x run.sh
# 2. Verificar sintaxe
bash -n run.sh
# 3. Testar execução (com venv criado)
./run.sh
Saída esperada:
==========================================
Sistema MCP - Operações Matemáticas
==========================================
🚀 Iniciando cliente MCP...
[Chat interface inicia]
📝 Notas
- O script assume que você está no diretório do projeto
- Funciona em Linux/Mac (no Windows, use Git Bash ou WSL)
- Instala dependências automaticamente se necessário
- Requer que o ambiente virtual já exista
🔧 Troubleshooting
Erro: "Permission denied"
chmod +x run.sh
Erro: "venv not found"
python3.11 -m venv venv
➡️ Próximo Passo
Após criar o script, prossiga para: 06-README-DOC.md