Web Search MCP Server

Web Search MCP Server

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

Características

• Busca en la web utilizando los resultados de búsqueda de DuckDuckGo
• No se requieren 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:

3. Consideraciones legales:
   • Esta herramienta está pensada para uso personal
   • Respeta los términos de servicio de Google

Contribuciones

¡No dudes en enviar problemas y solicitudes de mejora!