Skip to main content
Glama
MCP File Preview Server

MCP File Preview Server

by seanivore

Servidor de vista previa de archivos MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que ofrece funciones de previsualización y análisis de archivos HTML. Este servidor permite capturar capturas de pantalla completas de archivos HTML locales y analizar su estructura.

Características

  • Vista previa de archivo : captura capturas de pantalla de página completa de archivos HTML con el estilo CSS adecuado

  • Análisis de contenido : analizar la estructura HTML (encabezados, párrafos, imágenes, enlaces)

  • Compatibilidad con archivos locales : administre rutas y recursos de archivos locales

  • Gestión de capturas de pantalla : guarde las capturas de pantalla en un directorio dedicado

Related MCP server: polydoc-mcp

Instalación

  1. Clonar el repositorio:

git clone https://github.com/your-username/mcp-file-preview.git
cd mcp-file-preview
  1. Instalar dependencias:

npm install
  1. Construir el proyecto:

npm run build

Configuración

Agregue el servidor a su configuración de Claude o Cline MCP:

Aplicación de escritorio Claude

Agregar a ~/Library/Application Support/Claude/claude_desktop_config.json :

{
  "mcpServers": {
    "file-preview": {
      "command": "node",
      "args": ["/path/to/mcp-file-preview/build/index.js"]
    }
  }
}

Extensión Cline de VSCode

Agregar a la configuración MCP de VSCode:

{
  "mcpServers": {
    "file-preview": {
      "command": "node",
      "args": ["/path/to/mcp-file-preview/build/index.js"]
    }
  }
}

Uso

El servidor proporciona dos herramientas principales:

archivo de vista previa

Captura una captura de pantalla y devuelve contenido HTML:

<use_mcp_tool>
<server_name>file-preview</server_name>
<tool_name>preview_file</tool_name>
<arguments>
{
  "filePath": "/path/to/file.html",
  "width": 1024,  // optional
  "height": 768   // optional
}
</arguments>
</use_mcp_tool>

Las capturas de pantalla se guardan en el directorio screenshots/ en la carpeta del proyecto.

analizar_contenido

Analiza la estructura HTML:

<use_mcp_tool>
<server_name>file-preview</server_name>
<tool_name>analyze_content</tool_name>
<arguments>
{
  "filePath": "/path/to/file.html"
}
</arguments>
</use_mcp_tool>

Devuelve recuentos de:

  • Encabezados

  • Párrafos

  • Imágenes

  • Campo de golf

Desarrollo

  1. Instalar dependencias:

npm install @modelcontextprotocol/sdk puppeteer typescript @types/node @types/puppeteer
  1. Realizar cambios en src/

  2. Construir:

npm run build
  1. Prueba localmente:

npm run dev

Detalles de implementación

El servidor utiliza la clase Servidor del SDK de MCP con la inicialización adecuada:

this.server = new Server(
  // Metadata object
  {
    name: 'file-preview-server',
    version: '0.1.0'
  },
  // Options object with capabilities
  {
    capabilities: {
      tools: {
        preview_file: {
          description: 'Preview local HTML file and capture screenshot',
          inputSchema: {
            // ... schema definition
          }
        }
      }
    }
  }
);

Puntos clave:

  • El constructor del servidor toma objetos de opciones y metadatos separados

  • Las herramientas se declaran en capacidades.herramientas

  • Cada herramienta necesita una descripción y un esquema de entrada.

  • Las capturas de pantalla se guardan en un directorio local screenshots/

Depuración

  1. Utilice el inspector MCP:

npx @modelcontextprotocol/inspector
  1. Conectar con:

    • Tipo de transporte: STDIO

    • Comando: nodo

    • Argumentos: /ruta/a/compilar/index.js

  2. Consulte los registros del sistema operativo Claude si las herramientas no aparecen en el menú desplegable

Contribuyendo

Lea CONTRIBUTING.md para obtener detalles sobre nuestro código de conducta y el proceso para enviar solicitudes de extracción.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Available Tools

2 tools
analyze_contentC

Analyze HTML content structure

Inputs: filePath (required).

preview_fileB

Preview local HTML file and capture screenshot

Inputs: filePath (required), height, width.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: analyze_content focuses on structural analysis of HTML content, while preview_file handles file preview and screenshot capture. There is no overlap in functionality, making it easy for an agent to select the appropriate tool without confusion.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun naming pattern (analyze_content and preview_file), with clear, descriptive names that align with their functions. There are no deviations or mixed conventions, ensuring predictability and readability.

    Tool Count2/5

    With only two tools, the server feels thin for a 'File Preview Server' that might be expected to handle more file types or operations beyond HTML. While the tools are focused, the count is borderline too few for the apparent scope, limiting functionality.

    Completeness2/5

    The server is severely incomplete for file preview purposes, as it only supports HTML files with no coverage for other common formats (e.g., images, PDFs, text files). There are significant gaps in the tool surface that will likely cause agent failures when dealing with non-HTML content.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server that converts HTML or URLs to PDF, captures screenshots, and generates EU-compliant e-invoices (Factur-X/ZUGFeRD).
      44 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      A lightweight MCP server for parsing HTML, fetching URLs, rendering terminal-style screenshots, and executing JavaScript on static HTML without external dependencies.
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Screenshot and HTML Rendering MCP Server for AI Agents. Capture screenshots, render HTML to images, and generate PDFs via simple API calls. Compatible with Claude, Cursor, and any MCP client.
      1
      MIT