Google Search Engine

Google Search Engine MCP Server

Um servidor MCP (Model Context Protocol) baseado em Cloudflare Workers, fornecendo funcionalidade de busca no Google e extração de conteúdo de páginas web com login OAuth integrado.

Desenvolvimento Local

# Clone the repository
git clone https://github.com/your-username/google-search-engine-mcp-server.git

# Install dependencies
cd google-search-engine-mcp-server
npm install

# Run locally
npm run dev

Visite http://localhost:8787/ para verificar o status do servidor

Conectar à Ferramenta de Teste MCP Inspector

Use o MCP Inspector para explorar e testar a API:

• Execute npm run inspector ou npx @modelcontextprotocol/inspector
• Na interface do Inspector, defina o tipo de transporte para SSE, URL para http://localhost:8787/sse, e clique em "Conectar"
• Insira qualquer e-mail e senha na interface de login simulada
• Após o login, você pode visualizar e chamar todas as ferramentas disponíveis

Ferramentas Disponíveis

Este servidor fornece as seguintes ferramentas:

1. google_search - Realiza buscas no Google e retorna resultados
2. extract_webpage_content - Extrai o conteúdo de páginas web e converte em texto legível
3. batch_extract_webpage_content - Extrai conteúdo de várias páginas web em lote

Conectar ao Claude Desktop

Para conectar o Claude ao seu servidor MCP local:

1. Siga o Guia de Início Rápido da Anthropic
2. No Claude Desktop, vá em Configurações > Desenvolvedor > Editar Configuração
3. Substitua o conteúdo existente pela seguinte configuração:

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

Após iniciar o Claude, uma janela do navegador será aberta permitindo que você faça login. Você pode ver as ferramentas disponíveis no canto inferior direito. Com prompts apropriados, o Claude chamará as ferramentas correspondentes.

Implantar no Cloudflare

1. Crie um namespace KV: npx wrangler kv namespace create OAUTH_KV
2. Siga as instruções para adicionar o ID do namespace KV a wrangler.jsonc
3. Defina as variáveis de ambiente:
   • GOOGLE_API_KEY - Sua chave de API do Google
   • GOOGLE_SEARCH_ENGINE_ID - Seu ID do Google Custom Search Engine
4. Implante: npm run deploy

Conectar ao Servidor MCP Remoto

Após a implantação, você pode usar o MCP Inspector para conectar ao servidor remoto:

npx @modelcontextprotocol/inspector@latest

Insira sua URL do Workers (por exemplo, your-worker-name.your-account.workers.dev/sse) como endereço do servidor MCP e clique em "Conectar".

Conectar o Claude Desktop ao Servidor Remoto

Atualize o arquivo de configuração do Claude para apontar para sua URL do Workers:

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-worker-name.your-account.workers.dev/sse"
      ]
    }
  }
}

Solução de Problemas

Se você encontrar problemas:

1. Reinicie o Claude
2. Tente conectar ao servidor MCP diretamente pela linha de comando:

   npx mcp-remote http://localhost:8787/sse
   

3. Limpe os arquivos de autenticação do MCP:

   rm -rf ~/.mcp-auth
   

4. Verifique os logs do console para obter informações detalhadas de erro

Notas do Desenvolvedor

• Este projeto é desenvolvido usando TypeScript
• Baseado em Cloudflare Workers e Durable Objects
• Integra autenticação OAuth
• Usa a API de Pesquisa Personalizada do Google para funcionalidade de busca
• Inclui recursos de extração e análise de conteúdo de páginas web