Gemini CLI: Seu Portal para a IA no Terminal

O que é o Gemini CLI?

O Gemini Command Line Interface (CLI) é uma ferramenta poderosa que traz a capacidade dos modelos de linguagem do Google Gemini diretamente para o seu terminal. Ele permite que você interaja com a IA para uma vasta gama de tarefas, desde a geração de código e depuração até a análise de projetos e automação de fluxos de trabalho. Com o Gemini CLI, seu terminal se torna um parceiro inteligente, capaz de entender e executar suas intenções em linguagem natural.

Esta página irá guiá-lo passo a passo na instalação e configuração do Gemini CLI, integrando-o com ferramentas essenciais como VSCode e GitHub, e explorando o potencial dos servidores MCP (Model Context Protocol) para estender ainda mais suas funcionalidades.

1. Instalação do Gemini CLI no WSL2

Para uma experiência de desenvolvimento robusta no Windows, recomendamos a instalação do Gemini CLI no WSL2 (Windows Subsystem for Linux 2). Isso oferece um ambiente Linux completo e otimizado.

Pré-requisitos:

• WSL2 Instalado: Certifique-se de que o WSL2 esteja configurado no seu sistema Windows. Você pode seguir as instruções oficiais da Microsoft.
• Node.js e npm: O Gemini CLI é uma aplicação Node.js. Certifique-se de ter o Node.js (versão 18+ recomendada) e o npm (gerenciador de pacotes do Node.js) instalados no seu ambiente WSL2.

# Verifique se o Node.js e o npm estão instalados
node -v
npm -v

Passos de Instalação:

1. Abra seu terminal WSL2 (por exemplo, Ubuntu no WSL).
2. Instale o Gemini CLI globalmente usando o npm:

   npm install -g @google/gemini-cli

3. Após a instalação, inicialize o Gemini CLI. Na primeira execução, você será solicitado a autenticar sua conta Google.

   gemini

Parabéns! O Gemini CLI está agora instalado e pronto para uso no seu ambiente WSL2.

2. Integrando o Gemini CLI ao VSCode

O VSCode é um ambiente de desenvolvimento integrado (IDE) popular. Integrar o Gemini CLI ao VSCode otimiza seu fluxo de trabalho, permitindo que você use os recursos de IA diretamente do seu editor.

Passos de Integração:

1. Abra o VSCode.
2. Instale a extensão "Remote - WSL" (se ainda não tiver) para trabalhar diretamente com seu ambiente WSL2.

   (Procure por "Remote - WSL" na aba de Extensões do VSCode e instale-a).

3. Abra uma pasta WSL no VSCode. Você pode fazer isso clicando no ícone de "Remote Explorer" na barra lateral esquerda e selecionando sua distribuição WSL.
4. Abra o terminal integrado do VSCode (Ctrl+` ou View > Terminal).
5. Agora você pode usar os comandos do Gemini CLI diretamente neste terminal.

   gemini --help

Com essa integração, você pode pedir ao Gemini para analisar seu código, gerar testes ou refatorar funções sem sair do seu ambiente de desenvolvimento.

3. GitHub: Clonar e Analisar Projetos

O Gemini CLI é excelente para entender e interagir com bases de código existentes. Vamos ver como clonar um repositório do GitHub e usar o Gemini para analisá-lo.

Passos:

1. Abra o terminal integrado do VSCode (ou seu terminal WSL2).
2. Clone um repositório GitHub de sua escolha. Por exemplo:

   git clone https://github.com/octocat/Spoon-Knife.git
   cd Spoon-Knife

3. Dentro do diretório do projeto, você pode usar o Gemini CLI para analisar a base de código.

   # Exemplo: Peça ao Gemini para descrever a arquitetura do projeto
   gemini "Explore o diretório atual e descreva a arquitetura do projeto."

   O Gemini CLI pode ler os arquivos do seu projeto e fornecer resumos, explicações e até mesmo sugerir melhorias.

Essa capacidade é incrivelmente útil para desenvolvedores que precisam rapidamente se familiarizar com novos projetos ou depurar bases de código complexas.

4. Integrando com Servidores MCP via VSCode (`settings.json`)

Os Servidores MCP (Model Context Protocol) são extensões que permitem ao Gemini CLI interagir com ferramentas e fontes de dados externas. Isso expande drasticamente o que o Gemini pode fazer, conectando-o a APIs, bancos de dados e serviços específicos.

Passo a Passo para Configurar um MCP:

mkdir -p ~/.gemini

code ~/.gemini/settings.json

3

Encontrar um Servidor MCP:

Existem diversos servidores MCP disponíveis. Você pode encontrar uma lista de integrações oficiais e populares no repositório Model Context Protocol Servers no GitHub.

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal"
}

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal",
  "mcpServers": {
    "malwarebazaar": {
      "description": "Malware Bazaar MCP Server",
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\XXX\\Document\\MalwareBazaar_MCP", // Substitua pelo seu caminho real
        "run",
        "malwarebazaar_mcp.py"
      ]
    }
  }
}

Após salvar o settings.json, o Gemini CLI reconhecerá o novo servidor MCP.

5. Uso Prático das Conexões MCP

Com o servidor MCP configurado, você pode agora interagir com ele diretamente do seu Gemini CLI.

Conectando-se e Consultando o MCP:

1. Abra seu terminal WSL2 ou o terminal integrado do VSCode.
2. Para listar os servidores MCP disponíveis, use o comando:

   /mcp

   Isso deve mostrar "malwarebazaar" (ou o nome que você deu ao seu servidor) na lista.

3. Para interagir com o MalwareBazaar_MCP, você pode usar prompts em linguagem natural que o Gemini CLI traduzirá em chamadas para as ferramentas do MCP.

   Exemplos de uso com o MalwareBazaar_MCP:

   # Peça as 5 amostras mais recentes
   gemini "Me mostre as 5 amostras de malware mais recentes do Malware Bazaar."
   
   # Obtenha informações sobre um hash específico (substitua pelo hash real)
   gemini "Qual é a informação detalhada sobre o hash de malware 0x123abc..."
   
   # Baixe uma amostra de malware (use com cautela e em ambiente seguro!)
   gemini "Baixe a amostra de malware com o hash 0x456def..."

   O Gemini CLI usará as ferramentas get_recent, get_info e get_file do MalwareBazaar_MCP, respectivamente, para executar essas ações.

Essa capacidade de estender o Gemini CLI com servidores MCP personalizados abre um mundo de possibilidades para automação e integração de IA em seus fluxos de trabalho específicos.

6. Explore Outros Servidores MCP!

O ecossistema de servidores MCP está em constante crescimento. Explore a lista de servidores populares e integrações oficiais para descobrir como você pode estender ainda mais as capacidades do seu Gemini CLI: