MCP DuckDuckGo Search Server

by spences10
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows web search functionality using the DuckDuckGo search engine, providing knowledge graph information, organic search results, news articles, video content, image results, and related searches with support for region-specific search, safe search levels, and date-based filtering

búsqueda mcp-duckduckgo


⚠️ Aviso

Este repositorio ya no se mantiene.

La funcionalidad de esta herramienta ahora está disponible en mcp-omnisearch , que combina múltiples herramientas MCP en un paquete unificado.

Utilice mcp-omnisearch en su lugar.


Un servidor de Protocolo de Contexto de Modelo (MCP) para integrar las funciones de búsqueda de DuckDuckGo con LLM. Este servidor proporciona una completa funcionalidad de búsqueda web compatible con diversos tipos de resultados y opciones de filtrado.

Características

  • 🔍 Búsqueda web completa utilizando el motor de búsqueda de DuckDuckGo
  • 📊 Tipos de resultados enriquecidos que incluyen:
    • Información del gráfico de conocimiento
    • Resultados de búsqueda orgánicos
    • Artículos de noticias
    • Contenido de vídeo
    • Resultados de la imagen
    • Búsquedas relacionadas
  • 🌍 Soporte de búsqueda específico para cada región
  • 🛡️ Niveles de búsqueda segura configurables
  • 📅 Opciones de filtrado basadas en fechas
  • 📄 Soporte de paginación
  • 💾 Almacenamiento en caché de resultados integrado
  • 🔒 Opciones de búsqueda segura (desactivada, moderada, estricta)

Configuración

Este servidor requiere configuración a través de su cliente MCP. A continuación, se muestran ejemplos para diferentes entornos:

Configuración de Cline

Agregue esto a su configuración de Cline MCP:

{ "mcpServers": { "mcp-duckduckgo-search": { "command": "npx", "args": ["-y", "mcp-duckduckgo-search"], "env": { "SERPAPI_KEY": "your-serpapi-api-key" } } } }

Escritorio Claude con configuración WSL

Para entornos WSL, agregue esto a su configuración de Claude Desktop:

{ "mcpServers": { "mcp-duckduckgo-search": { "command": "wsl.exe", "args": [ "bash", "-c", "source ~/.nvm/nvm.sh && SERPAPI_KEY=your-serpapi-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-duckduckgo-search" ] } } }

Variables de entorno

El servidor requiere la siguiente variable de entorno:

  • SERPAPI_KEY : Su clave SerpAPI (obligatoria)

API

El servidor implementa una única herramienta MCP con parámetros configurables:

búsqueda ddg

Realice búsquedas web utilizando el motor de búsqueda DuckDuckGo.

Parámetros:

  • query (cadena, obligatoria): Consulta de búsqueda
  • region (cadena, opcional): código de región (por ejemplo, us-en, uk-en) (predeterminado: us-en)
  • safe_search (cadena, opcional): Nivel de búsqueda segura (desactivado, moderado, estricto) (predeterminado: moderado)
  • date_filter (cadena, opcional): Filtrar resultados por fecha:
    • 'd': día pasado
    • 'w': semana pasada
    • 'm': mes pasado
    • 'y': año pasado
    • Rango personalizado: '2023-01-01..2023-12-31'
  • start (número, opcional): Desplazamiento del resultado para la paginación
  • no_cache (booleano, opcional): omite la caché para resultados nuevos (valor predeterminado: falso)

La respuesta incluye:

  • Datos del gráfico de conocimiento cuando estén disponibles
  • Resultados de búsqueda orgánicos
  • Artículos de noticias
  • Contenido de vídeo
  • Resultados de la imagen
  • Búsquedas relacionadas
  • Buscar metadatos

Desarrollo

Configuración

  1. Clonar el repositorio
  2. Instalar dependencias:
pnpm install
  1. Construir el proyecto:
pnpm build
  1. Ejecutar en modo de desarrollo:
pnpm dev

Publicación

El proyecto utiliza conjuntos de cambios para la gestión de versiones. Para publicar:

  1. Crear un conjunto de cambios:
pnpm changeset
  1. Versionar el paquete:
pnpm changeset version
  1. Publicar en npm:
pnpm release

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.

Expresiones de gratitud

-
security - not tested
A
license - permissive license
-
quality - not tested

Permite la integración con las capacidades de búsqueda de DuckDuckGo para LLM, lo que admite búsqueda web integral, filtrado regional, tipos de resultados y navegación segura con almacenamiento en caché y parámetros de búsqueda personalizables.

  1. ⚠️ Notice
    1. Features
      1. Configuration
        1. Cline Configuration
        2. Claude Desktop with WSL Configuration
        3. Environment Variables
      2. API
        1. ddg_search
      3. Development
        1. Setup
        2. Publishing
      4. Contributing
        1. License
          1. Acknowledgments
            ID: v99lwtriyk