Web Search MCP Server

Servidor MCP de Pesquisa Web

Um servidor Model Context Protocol (MCP) que permite pesquisa web gratuita usando resultados de busca do DuckDuckGo, sem necessidade de chaves de API.

Recursos

• Pesquise na web usando resultados de busca do DuckDuckGo
• Sem necessidade de chaves de API ou autenticação
• Retorna resultados estruturados com títulos, URLs e descrições
• Número configurável de resultados por pesquisa

Instalação

1. Clone ou baixe este repositório
2. Instale as dependências:

npm install

3. Compile o servidor:

npm run build

4. Adicione o servidor à sua configuração MCP:

Para VSCode (Extensão Claude Dev):

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

Para Claude Desktop:

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

Uso

O servidor fornece uma única ferramenta chamada search que aceita os seguintes parâmetros:

{
  "query": string,    // The search query
  "limit": number     // Optional: Number of results to return (default: 5, max: 10)
}

Exemplo de uso:

use_mcp_tool({
  server_name: "web-search",
  tool_name: "search",
  arguments: {
    query: "your search query",
    limit: 3  // optional
  }
})

Exemplo de resposta:

[
  {
    "title": "Example Search Result",
    "url": "https://example.com",
    "description": "Description of the search result..."
  }
]

Limitações

Como esta ferramenta utiliza raspagem web dos resultados de busca do Google, existem algumas limitações importantes a serem consideradas:

3. Considerações Legais:
   • Esta ferramenta é destinada ao uso pessoal
   • Respeite os termos de serviço do Google

Contribuição

Sinta-se à vontade para enviar problemas e solicitações de melhorias!