MCP Web Research Server

Servidor de Pesquisa Web MCP

Um servidor Model Context Protocol (MCP) para pesquisa na web.

Traga informações em tempo real para o Claude e pesquise facilmente qualquer tópico.

Recursos

• Integração com o Google Search
• Extração de conteúdo de páginas web
• Rastreamento de sessão de pesquisa (lista de páginas visitadas, consultas de pesquisa, etc.)
• Captura de tela

Pré-requisitos

• Node.js >= 18 (inclui npm e npx)
• Aplicativo Claude Desktop

Instalação

Primeiro, certifique-se de ter baixado e instalado o aplicativo Claude Desktop e de ter o npm instalado.

Em seguida, adicione esta entrada ao seu claude_desktop_config.json (no Mac, encontrado em ~/Library/Application\ Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "webresearch": {
      "command": "npx",
      "args": ["-y", "@mzxrai/mcp-webresearch@latest"]
    }
  }
}

Esta configuração permite que o Claude Desktop inicie automaticamente o servidor MCP de pesquisa web quando necessário.

Uso

Basta iniciar uma conversa com o Claude e enviar um prompt que se beneficiaria de pesquisa na web. Se você quiser um prompt pré-construído personalizado para pesquisa web mais aprofundada, você pode usar o prompt agentic-research que fornecemos através deste pacote. Acesse esse prompt no Claude Desktop clicando no ícone de clipe de papel no campo de entrada do chat e selecionando Choose an integration → webresearch → agentic-research.

Ferramentas

1. search_google

   • Realiza pesquisas no Google e extrai resultados
   • Argumentos: { query: string }

2. visit_page

   • Visita uma página web e extrai seu conteúdo
   • Argumentos: { url: string, takeScreenshot?: boolean }

3. take_screenshot

   • Tira uma captura de tela da página atual
   • Nenhum argumento necessário

Prompts

agentic-research

Um prompt de pesquisa guiada que ajuda o Claude a conduzir pesquisas web completas. O prompt instrui o Claude a:

• Começar com pesquisas amplas para entender o panorama do tópico
• Priorizar fontes de alta qualidade e autoridade
• Refinar iterativamente a direção da pesquisa com base nos resultados
• Manter você informado e permitir que você guie a pesquisa de forma interativa
• Sempre citar fontes com URLs

Recursos

Expomos duas coisas como recursos MCP: (1) capturas de tela de páginas web capturadas e (2) a sessão de pesquisa.

Capturas de tela

Quando você tira uma captura de tela, ela é salva como um recurso MCP. Você pode acessar as capturas de tela capturadas no Claude Desktop através do ícone de clipe de papel.

Sessão de pesquisa

O servidor mantém uma sessão de pesquisa que inclui:

• Consultas de pesquisa
• Páginas visitadas
• Conteúdo extraído
• Capturas de tela
• Registros de data e hora

Sugestões

Para obter os melhores resultados, se você optar por não usar o prompt agentic-research ao fazer sua pesquisa, pode ser útil sugerir fontes de alta qualidade para o Claude usar ao pesquisar tópicos gerais. Por exemplo, você pode usar o prompt news today from reuters or AP em vez de news today.

Problemas

Este é um código muito pré-alfa. E também é AIGC, então espere bugs.

Se você encontrar problemas, pode ser útil verificar os logs MCP do Claude Desktop:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Desenvolvimento

# Install dependencies
pnpm install

# Build the project
pnpm build

# Watch for changes
pnpm watch

# Run in development mode
pnpm dev

Requisitos

• Node.js >= 18
• Playwright (instalado automaticamente como dependência)

Plataformas Verificadas

• macOS
• Linux

Licença

MIT

Autor

mzxrai