Web Search

Web Search MCP Server

Un servidor de Model Context Protocol (MCP) que permite búsquedas web gratuitas utilizando resultados de búsqueda de Google, sin necesidad de claves API.

Características

• Busca en la web utilizando resultados de búsqueda de Google
• No requiere claves API ni autenticación
• Devuelve resultados estructurados con títulos, URLs y descripciones
• Número configurable de resultados por búsqueda

Instalación

1. Clona o descarga este repositorio
2. Instala las dependencias:

npm install

3. Compila el servidor:

npm run build

4. Añade el servidor a tu configuración de MCP:

Para VSCode (extensión 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

El servidor proporciona una única herramienta llamada search que acepta los siguientes parámetros:

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

Ejemplo de uso:

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

Ejemplo de respuesta:

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

Limitaciones

Dado que esta herramienta utiliza web scraping de los resultados de búsqueda de Google, hay algunas limitaciones importantes que debes tener en cuenta:

1. Límite de velocidad: Google puede bloquear temporalmente las solicitudes si se realizan demasiadas búsquedas en poco tiempo. Para evitarlo:

   • Mantén las búsquedas a una frecuencia razonable
   • Utiliza el parámetro limit con criterio
   • Considera implementar retrasos entre búsquedas si es necesario

2. Precisión de los resultados:

   • La herramienta depende de la estructura HTML de Google, que puede cambiar
   • Algunos resultados pueden carecer de descripciones u otros metadatos
   • Los operadores de búsqueda complejos pueden no funcionar como se espera

3. Consideraciones legales:

   • Esta herramienta está pensada para uso personal
   • Respeta los términos de servicio de Google
   • Considera implementar un límite de velocidad adecuado para tu caso de uso

Contribuciones

¡No dudes en enviar problemas y solicitudes de mejoras!