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.

Related MCP server: DuckDuckGo MCP Server

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

3. Construir el proyecto:

pnpm build

4. 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

2. Versionar el paquete:

pnpm changeset version

3. 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

• Construido sobre el Protocolo de Contexto Modelo

• Desarrollado por DuckDuckGo a través de SerpAPI