carlos19772023/servidor-mcp-website

O que servidor-mcp-website faz?

📸 Capture screenshots de páginas web de alta qualidade de forma eficiente, com divisão automática para otimizar o processamento em fluxos de IA.

Visão Geral

Este servidor MCP (Model Context Protocol) permite que agentes de IA capturem screenshots completos de páginas web. Ele é especialmente útil para:

• Análise visual de interfaces web
• Documentação de páginas e design
• Scraping visual de conteúdo
• Debug de elementos UI

Funcionalidades

• Captura de screenshots de página inteira
• Divisão automática em blocos (tiles) para processamento eficiente
• Suporte a diferentes resoluções de viewport
• Saída organizada em diretórios temporários
• Compatível com Claude Code, Cursor, Codex e outras ferramentas MCP

Como Usar

Configuração Adicionar ao se u arquivo de configuração MCP:

{
  "mcpServers": {
    "website-screenshot": {
      "command": "npx",
      "args": [
        "carlos19772023/mcp-server-website"
      ],
      "env": {
        // Opções de ambiente (opcional)
      }
    }
  }
}

Comandos Disponíveis

screenshot

Captura um screenshot completo de uma página web.

Parâmetros:

• url (obrigatório): URL da página
• tileWidth (opcional, padrão: 800): largura de cada bloco
• tileHeight (opcional, padrão: 600): altura de cada bloco
• viewportWidth (opcional, padrão: 1280): largura do viewport
• viewportHeight (opcional, padrão: 720): altura do viewport

Exemplo:

{
  "url": "https://exemplo.com",
  "tileWidth": 800,
  "tileHeight": 600
}

Resposta:

{
  "tiles": [
    "/tmp/screenshots/exemplo.com/tile_0_0.png",
    "/tmp/screenshots/exemplo.com/tile_0_1.png",
    "/tmp/screenshots/exemplo.com/tile_1_0.png"
  ],
  "totalTiles": 6,
  "fullPageSize": {
    "width": 1280,
    "height": 2400
  }
}

Funcionamento

1. O servidor recebe uma solicitação com a URL e parâmetros opcionais
2. Abre um navegador headless (Puppeteer) e navega até a URL
3. Captura um screenshot da página inteira
4. Divide o screenshot em blocos menores (tiles) de acordo com os parâmetros
5. Salva cada bloco em um arquivo PNG no diretório temporário
6. Retorna a lista de caminhos dos blocos e informações de tamanho

Requisitos

• Node.js 18.x ou superior
• Navegador Chromium (instalado automaticamente pelo Puppeteer)

Notas

• Os screenshots são temporários e podem ser limpos após a sessão
• URLs devem ser completas (incluindo protocolo)
• A divisão em blocos facilita o processamento por LLMs com limitações de tokens