DuckDuckGo Search

duckduckgo-search MCP Server

English | 中文

Um servidor Model Context Protocol para DuckDuckGo Search

Este é um servidor MCP baseado em TypeScript que fornece funcionalidade de busca DuckDuckGo. Ele demonstra conceitos centrais do MCP através de:

• Integração com DuckDuckGo Search
• Interface de ferramenta de busca fácil de usar
• Suporte a limite de taxa e tratamento de erros

Recursos

Ferramenta de Busca

• duckduckgo_search - Realize buscas na web usando a API do DuckDuckGo
  • Parâmetro obrigatório: query (consulta de busca, máximo 400 caracteres)
  • Parâmetro opcional: count (número de resultados, 1-20, padrão 10)
  • Parâmetro opcional: safeSearch (nível de segurança: strict/moderate/off, padrão moderate)
  • Retorna resultados de busca formatados em Markdown

Limites de Taxa

• Máximo de 1 requisição por segundo
• Máximo de 15000 requisições por mês

Desenvolvimento

Pré-requisitos

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

Instalação

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

# Install project dependencies
pnpm install

Compilar e Executar

Compile o servidor:

pnpm run build

Para desenvolvimento com recompilação automática:

pnpm run watch

Configuração no Claude Desktop

Para usar com o Claude Desktop, adicione a configuração do servidor:

No MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json No 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"
      ]
    }
  }
}

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector, que está disponível como um script de pacote:

pnpm run inspector

O Inspector fornecerá uma URL para acessar ferramentas de depuração no seu navegador.