Skip to main content
Glama
Sign In
enesjakozh

DuckDuckGo MCP Server

by nickclyde
Verified
GitHub
Python
MIT License
26
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

  • Provides web search capabilities through DuckDuckGo's search engine, including features for searching the web, retrieving and parsing webpage content, with rate limiting and result formatting optimized for large language model consumption.

Servidor MCP de búsqueda de DuckDuckGo

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona capacidades de búsqueda web a través de DuckDuckGo, con funciones adicionales para la búsqueda y análisis de contenido.

Características

  • Búsqueda web : Busque en DuckDuckGo con limitación de velocidad avanzada y formato de resultados
  • Obtención de contenido : recupere y analice el contenido de páginas web con extracción de texto inteligente
  • Limitación de velocidad : protección integrada contra límites de velocidad tanto para la búsqueda como para la obtención de contenido
  • Manejo de errores : manejo y registro de errores integral
  • Salida compatible con LLM : resultados formateados específicamente para un gran consumo de modelos de lenguaje

Instalación

Instalación mediante herrería

Para instalar DuckDuckGo Search Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @nickclyde/duckduckgo-mcp-server --client claude

Instalación mediante uv

Instalar directamente desde PyPI usando uv :

uv pip install duckduckgo-mcp-server

Uso

Ejecutando con Claude Desktop

  1. Descargar Claude Desktop
  2. Crea o edita tu configuración de Claude Desktop:
    • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • En Windows: %APPDATA%\Claude\claude_desktop_config.json

Agregue la siguiente configuración:

{ "mcpServers": { "ddg-search": { "command": "uvx", "args": ["duckduckgo-mcp-server"] } } }
  1. Reiniciar Claude Desktop

Desarrollo

Para el desarrollo local, puede utilizar la CLI de MCP:

# Run with the MCP Inspector mcp dev server.py # Install locally for testing with Claude Desktop mcp install server.py

Herramientas disponibles

1. Herramienta de búsqueda

async def search(query: str, max_results: int = 10) -> str

Realiza una búsqueda web en DuckDuckGo y devuelve resultados formateados.

Parámetros:

  • query : cadena de consulta de búsqueda
  • max_results : Número máximo de resultados a devolver (predeterminado: 10)

Devuelve: cadena formateada que contiene resultados de búsqueda con títulos, URL y fragmentos.

2. Herramienta de obtención de contenido

async def fetch_content(url: str) -> str

Obtiene y analiza el contenido de una página web.

Parámetros:

  • url : La URL de la página web de la que se obtendrá el contenido

Devuelve: Contenido de texto limpio y formateado de la página web.

Características en detalle

Limitación de velocidad

  • Búsqueda: Limitada a 30 solicitudes por minuto
  • Obtención de contenido: limitada a 20 solicitudes por minuto
  • Gestión automática de colas y tiempos de espera

Procesamiento de resultados

  • Elimina anuncios y contenido irrelevante.
  • Limpia las URL de redireccionamiento de DuckDuckGo
  • Formatos de resultados para un consumo óptimo de LLM
  • Trunca el contenido largo apropiadamente

Manejo de errores

  • Detección y generación de informes de errores completos
  • Registro detallado a través del contexto MCP
  • Degradación elegante en límites de velocidad o tiempos de espera

Contribuyendo

¡Agradecemos los problemas y las solicitudes de incorporación de cambios! Algunas áreas de mejora potenciales:

  • Parámetros de búsqueda adicionales (región, idioma, etc.)
  • Opciones de análisis de contenido mejoradas
  • Capa de almacenamiento en caché para contenido de acceso frecuente
  • Estrategias adicionales de limitación de velocidad

Licencia

Este proyecto está licenciado bajo la licencia MIT.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona capacidades de búsqueda web a través de DuckDuckGo, con funciones adicionales para la búsqueda y análisis de contenido.

  1. Features
    1. Installation
      1. Installing via Smithery
      2. Installing via uv
    2. Usage
      1. Running with Claude Desktop
      2. Development
    3. Available Tools
      1. 1. Search Tool
      2. 2. Content Fetching Tool
    4. Features in Detail
      1. Rate Limiting
      2. Result Processing
      3. Error Handling
    5. Contributing
      1. License

        Related Resources

        Appeared in Searches

        ID: phcus2gcpn