Servidor MCP de búsqueda web de DuckDuckGo

Este proyecto proporciona un servidor MCP (Protocolo de contexto de modelo) que le permite buscar en la web utilizando el motor de búsqueda DuckDuckGo y, opcionalmente, obtener y resumir el contenido de las URL encontradas.

Características

• Búsqueda web: busque en la web utilizando DuckDuckGo.

• Extracción de resultados: extrae títulos, URL y fragmentos de los resultados de búsqueda.

• Obtención de contenido (opcional): obtiene el contenido de las URL encontradas en los resultados de búsqueda y lo convierte a formato Markdown mediante la API de Jina.

• Obtención paralela: obtiene varias URL simultáneamente para un procesamiento más rápido.

• Manejo de errores: maneja con elegancia los tiempos de espera y otros errores potenciales durante la búsqueda y la obtención.

• Configurable: le permite establecer el número máximo de resultados de búsqueda que se devolverán.

• API de Jina : uso de la API de Jina para convertir HTML a Markdown.

• Compatible con MCP : este servidor está diseñado para usarse con cualquier cliente compatible con MCP.

Uso

1. Prerrequisitos:

   • gestor de paquetes uvx

2. Configuración del escritorio de Claude

   • Si está utilizando Claude Desktop, puede agregar el servidor al archivo claude_desktop_config.json .

   { "mcpServers": { "web-search-duckduckgo": { "command": "uvx", "args": [ "--from", "git+https://github.com/kouui/web-search-duckduckgo.git@main", "main.py" ] } } }

   La configuración anterior no funciona, es posible que deba clonar el repositorio en la PC local y usar la siguiente configuración

   { "mcpServers": { "web-search-duckduckgo": { "command": "uv", "args": [ "--directory", "/path/to/web-search-duckduckgo", "run", "main.py" ] } } }

3. Herramienta

   • En su cliente MCP (por ejemplo, Claude), ahora puede utilizar las siguientes herramientas:

   • search_and_fetch busca en la web y recupera el contenido de las URL.

     • query : La cadena de consulta de búsqueda.

     • limit : el número máximo de resultados a devolver (predeterminado: 3, máximo: 10).

   • fetch obtiene el contenido de una URL específica.

     • url : La URL a buscar.

Licencia

Este proyecto está licenciado bajo la licencia MIT. (Agregue un archivo de licencia si desea especificar una licencia).