Gemini MCP Tool

Gemini MCP Tool

📚 Ver Documentação Completa - Pesquise-me!, Exemplos, FAQ, Solução de problemas, Melhores práticas

Este é um servidor simples de Model Context Protocol (MCP) que permite que assistentes de IA interajam com o Gemini CLI. Ele permite que a IA aproveite o poder da enorme janela de tokens do Gemini para análises grandes, especialmente com arquivos grandes e bases de código usando a sintaxe @ para direção.

• Faça perguntas naturais ao gemini, através do claude ou faça um brainstorm de novas ideias em um grupo de 3!

TLDR: + ()

Objetivo: Use as poderosas capacidades de análise do Gemini diretamente no Claude Code para economizar tokens e analisar arquivos grandes.

Pré-requisitos

curl -fsSL https://antigravity.google/cli/install.sh | bash   # macOS / Linux

GEMINI_MCP_BACKEND=gemini

Antes de usar esta ferramenta, certifique-se de ter:

1. Node.js (v16.0.0 ou superior)
2. Google Gemini CLI instalado e configurado

Configuração em uma linha

claude mcp add gemini-cli -- npx -y gemini-mcp-tool

claude mcp add gemini-cli -- npx -- y gemini-mcp-tool

Verificar instalação

Digite /mcp dentro do Claude Code para verificar se o MCP gemini-cli está ativo.

Alternativa: Importar do Claude Desktop

Se você já o configurou no Claude Desktop:

1. Adicione à sua configuração do Claude Desktop:

"gemini-cli": {
  "command": "npx",
  "args": ["-y", "gemini-mcp-tool"]
}

2. Importe para o Claude Code:

claude mcp add-from-claude-desktop

Configuração

Registre o servidor MCP com seu cliente MCP:

Para uso com NPX (Recomendado)

Adicione esta configuração ao arquivo de configuração do Claude Desktop:

{
  "mcpServers": {
    "gemini-cli": {
      "command": "npx",
      "args": ["-y", "gemini-mcp-tool"]
    }
  }
}

Para instalação global

Se você instalou globalmente, use esta configuração em vez disso:

{
  "mcpServers": {
    "gemini-cli": {
      "command": "gemini-mcp"
    }
  }
}

Locais dos arquivos de configuração:

• Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/claude/claude_desktop_config.json

Após atualizar a configuração, reinicie sua sessão de terminal.

Exemplo de fluxo de trabalho

• Linguagem natural: "use gemini para explicar index.html", "entenda o projeto massivo usando gemini", "peça ao gemini para pesquisar as últimas notícias"
• Claude Code: Digite /gemini-cli e os comandos serão preenchidos na interface do Claude Code.

Exemplos de uso

Com referências a arquivos (usando sintaxe @)

• ask gemini to analyze @src/main.js and explain what it does
• use gemini to summarize @. the current directory
• analyze @package.json and tell me about dependencies

Perguntas gerais (sem arquivos)

• ask gemini to search for the latest tech news
• use gemini to explain div centering
• ask gemini about best practices for React development related to @file_im_confused_about

Usando o modo sandbox do Gemini CLI (-s)

O modo sandbox permite testar com segurança alterações de código, executar scripts ou realizar operações potencialmente arriscadas em um ambiente isolado.

• use gemini sandbox to create and run a Python script that processes data
• ask gemini to safely test @script.py and explain what it does
• use gemini sandbox to install numpy and create a data visualization
• test this code safely: Create a script that makes HTTP requests to an API

Ferramentas (para a IA)

Estas ferramentas são projetadas para serem usadas pelo assistente de IA.

• ask-gemini: Pergunta ao Google Gemini pela sua perspectiva. Pode ser usado para perguntas gerais ou análise complexa de arquivos.
  • prompt (obrigatório): A solicitação de análise. Use a sintaxe @ para incluir referências a arquivos ou diretórios (por exemplo, @src/main.js explain this code) ou faça perguntas gerais (por exemplo, Please use a web search to find the latest news stories).
  • model (opcional): O modelo Gemini a ser usado. O padrão é gemini-2.5-pro.
  • sandbox (opcional): Defina como true para executar em modo sandbox para execução segura de código.
• sandbox-test: Executa com segurança código ou comandos no ambiente sandbox do Gemini. Sempre executa em modo sandbox.
  • prompt (obrigatório): Solicitação de teste de código (por exemplo, Create and run a Python script that... ou @script.py Run this safely).
  • model (opcional): O modelo Gemini a ser usado.
• Ping: Uma ferramenta de teste simples que ecoa uma mensagem de volta.
• Help: Mostra o texto de ajuda do Gemini CLI.

Comandos de barra (para o usuário)

Você pode usar esses comandos diretamente na interface do Claude Code (a compatibilidade com outros clientes não foi testada).

• /analyze: Analisa arquivos ou diretórios usando o Gemini, ou faz perguntas gerais.
  • prompt (obrigatório): O prompt de análise. Use a sintaxe @ para incluir arquivos (por exemplo, /analyze prompt:@src/ summarize this directory) ou faça perguntas gerais (por exemplo, /analyze prompt:Please use a web search to find the latest news stories).
• /sandbox: Testa com segurança código ou scripts no ambiente sandbox do Gemini.
  • prompt (obrigatório): Solicitação de teste de código (por exemplo, /sandbox prompt:Create and run a Python script that processes CSV data ou /sandbox prompt:@script.py Test this script safely).
• /help: Exibe as informações de ajuda do Gemini CLI.
• /ping: Testa a conexão com o servidor.
  • message (opcional): Uma mensagem para ecoar de volta.

Contribuindo

Contribuições são bem-vindas! Consulte nossas Diretrizes de Contribuição para detalhes sobre como enviar pull requests, relatar problemas e contribuir com o projeto.

Licença

Este projeto é licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.

Aviso legal: Esta é uma ferramenta não oficial de terceiros e não é afiliada, endossada ou patrocinada pelo Google.