Web Search

Servidor Web Search MCP

Um servidor Model Context Protocol (MCP) que permite buscas gratuitas na web usando resultados do Google, sem necessidade de chaves de API.

Recursos

• Busque na web usando resultados do Google
• Sem chaves de API ou autenticação necessárias
• Retorna resultados estruturados com títulos, URLs e descrições
• Número configurável de resultados por busca

Instalação

1. Clone ou baixe este repositório
2. Instale as dependências:

npm install

3. Compile o servidor:

npm run build

4. Adicione o servidor à sua configuração MCP:

Para VSCode (Extensão Claude Dev):

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/web-search/build/index.js"]
    }
  }
}

Para Claude Desktop:

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/web-search/build/index.js"]
    }
  }
}

Uso

O servidor fornece uma única ferramenta chamada search que aceita os seguintes parâmetros:

{
  "query": string,    // The search query
  "limit": number     // Optional: Number of results to return (default: 5, max: 10)
}

Exemplo de uso:

use_mcp_tool({
  server_name: "web-search",
  tool_name: "search",
  arguments: {
    query: "your search query",
    limit: 3  // optional
  }
})

Exemplo de resposta:

[
  {
    "title": "Example Search Result",
    "url": "https://example.com",
    "description": "Description of the search result..."
  }
]

Limitações

Como esta ferramenta utiliza raspagem de resultados de busca do Google, há algumas limitações importantes a serem consideradas:

1. Limite de Requisições: O Google pode bloquear temporariamente requisições se muitas buscas forem realizadas em um curto período. Para evitar isso:

   • Mantenha as buscas em uma frequência razoável
   • Use o parâmetro de limite com moderação
   • Considere implementar atrasos entre buscas, se necessário

2. Precisão dos Resultados:

   • A ferramenta depende da estrutura HTML do Google, que pode mudar
   • Alguns resultados podem não ter descrições ou outros metadados
   • Operadores de busca complexos podem não funcionar como esperado

3. Considerações Legais:

   • Esta ferramenta é destinada ao uso pessoal
   • Respeite os termos de serviço do Google
   • Considere implementar limites de requisições adequados para o seu caso de uso

Contribuição

Sinta-se à vontade para enviar problemas e solicitações de melhorias!