Google Web Search (Gemini)

Gemini Google Web Search MCP Server

Um servidor MCP (Model Context Protocol) que fornece funcionalidade de Pesquisa Google na Web usando a API Gemini. Este servidor é extraído da ferramenta de pesquisa web do CLI oficial do Gemini.

Recursos

• Pesquisa Google na Web via API Gemini
• Suporte a citações com links de origem
• Metadados de fundamentação para recuperação precisa de informações
• Totalmente compatível com Claude Desktop e outros clientes MCP

Pré-requisitos

• Node.js 18+
• Chave da API Google (acesso à API Gemini)

Instalação

Via npm (quando publicado)

npm install -g gemini-google-web-search-mcp

A partir do código-fonte

git clone https://github.com/yourusername/gemini-google-web-search-mcp.git
cd gemini-google-web-search-mcp
npm install
npm run build

Configuração

1. Obtenha uma chave da API Google

Visite o Google AI Studio para criar sua chave de API.

2. Configure o Claude Desktop

Adicione o seguinte ao seu arquivo de configuração do 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

Opção 1: Autenticação por chave de API

{
  "mcpServers": {
    "google-web-search": {
      "command": "node",
      "args": ["/path/to/gemini-google-web-search-mcp/dist/index.js"],
      "env": {
        "GOOGLE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Opção 2: Autenticação OAuth (sem necessidade de chave de API)

{
  "mcpServers": {
    "google-web-search": {
      "command": "node",
      "args": ["/path/to/gemini-google-web-search-mcp/dist/index-codeassist.js"],
      "env": {
        "USE_OAUTH": "true"
      }
    }
  }
}

Uso

Uma vez configurado, a ferramenta google_web_search estará disponível no Claude Desktop. Você pode usá-la pedindo ao Claude para pesquisar informações:

• "Pesquise as últimas notícias sobre o protocolo MCP"
• "Encontre informações sobre os recursos do TypeScript 5.0"
• "Consulte os desenvolvimentos recentes em segurança de IA"

Variáveis de Ambiente

• GOOGLE_API_KEY ou GEMINI_API_KEY: Sua chave da API Google (obrigatória)
• GEMINI_MODEL: Modelo Gemini a ser usado (padrão: gemini-2.0-flash-exp)
• USE_OAUTH: Defina como true para usar autenticação OAuth (experimental, não totalmente suportada)
• GOOGLE_APPLICATION_CREDENTIALS: Caminho para as credenciais da conta de serviço (opcional)

Métodos de Autenticação

1. Autenticação por chave de API (recomendada)

A maneira mais fácil de autenticar é usando uma chave de API:

export GOOGLE_API_KEY=your-api-key-here

2. Autenticação OAuth com a API Code Assist (configuração necessária)

A autenticação OAuth usa a API Code Assist do Google, que fornece funcionalidade de pesquisa web com login do Google.

Etapas de configuração:

1. Defina as credenciais OAuth (se estiver usando um aplicativo OAuth personalizado):

   export OAUTH_CLIENT_ID=your-oauth-client-id
   export OAUTH_CLIENT_SECRET=your-oauth-client-secret
   

2. Execute o script de configuração automatizado:

   ./setup-gcp.sh
   

3. Ou configure manualmente:

   # Set your Google Cloud project ID
   export GOOGLE_CLOUD_PROJECT=your-project-id
   
   # Enable required APIs
   gcloud services enable cloudaicompanion.googleapis.com
   
   # Set up authentication
   gcloud auth application-default login \
     --scopes=https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/generative-language.retriever
   

4. Use a autenticação OAuth:

   export USE_OAUTH=true
   npm run dev:cli -- "your search query"
   

Requisitos:

• Projeto Google Cloud com faturamento ativado
• API Cloud AI Companion ativada
• Assinatura do Gemini Code Assist (nível gratuito disponível)

Nota: Isso usa o mesmo fluxo de autenticação do Gemini CLI e acessa a API Code Assist do Google para funcionalidade de pesquisa web.

Desenvolvimento

Compilação

npm run build

Execução em desenvolvimento

npm run dev

Testes

# Set your API key
export GOOGLE_API_KEY=your-api-key-here

# Run the test
npm test

Implementação do Protocolo MCP

Este servidor implementa o Model Context Protocol com:

• Ferramenta: google_web_search
  • Entrada: query (string) - A consulta de pesquisa
  • Saída: Resultados de pesquisa com citações e links de origem

Licença

Apache 2.0 - Este projeto é derivado do Gemini CLI do Google, licenciado sob Apache 2.0.

Créditos

Este servidor MCP é baseado na funcionalidade de pesquisa web do Gemini CLI oficial do Google.

Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Solução de Problemas

Problemas com a chave de API

• Certifique-se de que sua chave de API seja válida e tenha acesso à API Gemini
• Verifique se a variável de ambiente está definida corretamente

Problemas de conexão

• Verifique se o servidor MCP está configurado corretamente no Claude Desktop
• Verifique os logs do servidor para mensagens de erro

Pesquisa não funcionando

• Certifique-se de ter conectividade com a internet
• Verifique se a API Gemini está acessível do seu local
• Verifique se sua chave de API não excedeu os limites de taxa