Files
oci_tips/GenAI/mcp/sample1/vibe/05-RUN-SCRIPT.md
2025-12-03 11:49:34 -03:00

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