Servidor MCP de búsqueda web

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite la búsqueda web gratuita utilizando los resultados de búsqueda de Google, sin necesidad de claves API.

Características

Busque en la web utilizando los resultados de búsqueda de Google
No se requieren claves API ni autenticación
Devuelve resultados estructurados con títulos, URL y descripciones.
Número configurable de resultados por búsqueda

Instalación

Clonar o descargar este repositorio
Instalar dependencias:

npm install

Construir el servidor:

npm run build

Agregue el servidor a su configuración de MCP:

Para VSCode (extensión de 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 el raspado web de los resultados de búsqueda de Google, hay algunas limitaciones importantes que se deben tener en cuenta:

Limitación de frecuencia : Google podría bloquear temporalmente las solicitudes si se realizan demasiadas búsquedas en poco tiempo. Para evitarlo:
- Mantenga las búsquedas a una frecuencia razonable
- Utilice el parámetro límite con prudencia
- Considere implementar retrasos entre búsquedas si es necesario
Precisión del resultado :
- La herramienta se basa en la estructura HTML de Google, que puede cambiar.
- Es posible que a algunos resultados les falten descripciones u otros metadatos.
- Es posible que los operadores de búsqueda complejos no funcionen como se espera
Consideraciones legales :
- Esta herramienta está destinada para uso personal.
- Respete las condiciones de servicio de Google
- Considere implementar una limitación de velocidad adecuada para su caso de uso

Contribuyendo

¡No dudes en enviarnos problemas y solicitudes de mejora!