DuckDuckGo Search

Servidor MCP de duckduckgo-search

Inglés | 中文

Un servidor de Protocolo de Contexto de Modelo para DuckDuckGo Search

Este es un servidor MCP basado en TypeScript que proporciona funcionalidad de búsqueda en DuckDuckGo. Demuestra conceptos centrales de MCP a través de:

• Integración con DuckDuckGo Search
• Interfaz de herramienta de búsqueda fácil de usar
• Soporte de límite de velocidad y manejo de errores

Características

Herramienta de Búsqueda

• duckduckgo_search - Realiza búsquedas web usando la API de DuckDuckGo
  • Parámetro requerido: query (consulta de búsqueda, máximo 400 caracteres)
  • Parámetro opcional: count (número de resultados, 1-20, predeterminado 10)
  • Parámetro opcional: safeSearch (nivel de seguridad: estricto/moderado/desactivado, predeterminado moderado)
  • Devuelve resultados de búsqueda formateados en Markdown

Límites de Velocidad

• Máximo 1 solicitud por segundo
• Máximo 15000 solicitudes por mes

Desarrollo

Requisitos Previos

• Node.js >= 18
• pnpm >= 8.0.0

Instalación

# Install pnpm if not already installed
npm install -g pnpm

# Install project dependencies
pnpm install

Compilación y Ejecución

Compila el servidor:

pnpm run build

Para desarrollo con recompilación automática:

pnpm run watch

Configuración en Claude Desktop

Para usar con Claude Desktop, agrega la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

# online
{
  "mcpServers": {
    "duckduckgo-search": {
        "command": "npx",
        "args": [
          "-y",
          "duckduckgo-mcp-server"
        ]
    }
  }
}

# local
{
  "mcpServers": {
    "duckduckgo-search": {
      "command": "node",
      "args": [
        "/path/to/duckduckgo-search/build/index.js"
      ]
    }
  }
}

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser desafiante. Recomendamos usar el Inspector MCP, que está disponible como un script de paquete:

pnpm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en tu navegador.