Convertidor de formato de URL MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que obtiene contenido de cualquier URL y lo convierte al formato de salida deseado.

Descripción general

El Conversor de Formato de URL de MCP ofrece herramientas para recuperar contenido de cualquier URL web y transformarlo a diversos formatos (HTML, JSON, Markdown o texto sin formato), independientemente del tipo de contenido original. Está diseñado para funcionar con cualquier cliente compatible con MCP, incluido Claude for Desktop, lo que permite a los LLM acceder, transformar y analizar contenido web en un formato consistente.

Related MCP server: Unstructured Document Processor MCP

Características

• 🔄 Conversión de formato : transforma cualquier contenido web a HTML, JSON, Markdown o texto sin formato

• 🌐 Soporte de entrada universal : maneja sitios web, API, archivos sin procesar y más

• 🔍 Detección automática de contenido : identifica de forma inteligente el formato de origen

• 🧰 Soporte robusto de bibliotecas : utiliza bibliotecas estándar de la industria:

  • ¡Adiós al análisis de HTML!

  • Marcado para procesamiento Markdown

  • Analizador rápido de XML para el manejo de XML

  • CSVtoJSON para conversión CSV

  • SanitizeHTML para seguridad

  • Desactivación de la conversión de HTML a Markdown

• 🔧 Procesamiento de formato avanzado :

  • Análisis de HTML con extracción de metadatos

  • Impresión bonita de JSON y conservación de la estructura

  • Representación de Markdown con estilo

  • Conversión de CSV a tabla

  • Transformación de XML a JSON

• 📜 Seguimiento del historial : mantiene registros de las URL obtenidas recientemente

• Enfoque de seguridad : Saneamiento de contenido para prevenir ataques XSS

Instalación

Prerrequisitos

• Node.js 16.x o superior

• npm o hilo

Inicio rápido

1. Clonar el repositorio:

   git clone https://github.com/yourusername/mcp-url-converter.git cd mcp-url-converter

2. Instalar dependencias:

   npm install

3. Construir el proyecto:

   npm run build

4. Ejecutar el servidor:

   npm start

Integración con Claude para escritorio

1. Abra el archivo de configuración de Claude for Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json

2. Añade el servidor convertidor de URL a tu configuración:

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

3. Reiniciar Claude para escritorio

Herramientas disponibles

fetch

Obtiene contenido de cualquier URL y detecta automáticamente el mejor formato de salida.

Parámetros:

• url (cadena, obligatoria): la URL desde la que se obtendrá el contenido

• format (cadena, opcional): Formato al que se convertirá ( auto , html , json , markdown , text ). Predeterminado: auto

Ejemplo:

fetch-json

Obtiene contenido de cualquier URL y lo convierte al formato JSON.

Parámetros:

• url (cadena, obligatoria): la URL desde la que se obtendrá el contenido

• prettyPrint (booleano, opcional): Si se imprime el JSON de forma estética. Predeterminado: true

Ejemplo:

fetch-html

Obtiene contenido de cualquier URL y lo convierte a formato HTML.

Parámetros:

• url (cadena, obligatoria): la URL desde la que se obtendrá el contenido

• extractText (booleano, opcional): Si se extrae solo el texto. Predeterminado: false

Ejemplo:

fetch-markdown

Obtiene contenido de cualquier URL y lo convierte al formato Markdown.

Parámetros:

• url (cadena, obligatoria): la URL desde la que se obtendrá el contenido

Ejemplo:

fetch-text

Obtiene contenido de cualquier URL y lo convierte a formato de texto sin formato.

Parámetros:

• url (cadena, obligatoria): la URL desde la que se obtendrá el contenido

Ejemplo:

web-search e deep-research

Estas herramientas proporcionan interfaces a las capacidades de búsqueda de Perplexity (cuando el host MCP las admite).

Recursos disponibles

recent-urls://list

Devuelve una lista de URL obtenidas recientemente con marcas de tiempo y formatos de salida.

Ejemplo:

Seguridad

Este servidor implementa varias medidas de seguridad:

• Sanitización de HTML usando sanitize-html para prevenir ataques XSS

• Validación de contenido antes del procesamiento

• Manejo de errores y valores predeterminados seguros

• Validación de parámetros de entrada con Zod

• Codificación de salida segura

Pruebas

Puede probar el servidor utilizando el Inspector MCP:

Solución de problemas

Problemas comunes

1. Errores de conexión : Verifique que la URL sea accesible y tenga el formato correcto

2. Errores de conversión : Es posible que algunos contenidos complejos no se conviertan correctamente entre formatos.

3. Problemas de origen cruzado : algunos sitios web pueden bloquear solicitudes de fuentes desconocidas

Modo de depuración

Para obtener información de depuración adicional, configure la variable de entorno DEBUG :

Licencia

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

Expresiones de gratitud

• Construido con el Protocolo de Contexto de Modelo

• Utiliza bibliotecas modernas, mantenidas activamente y con enfoque en la seguridad.

• Enfoque de saneamiento basado en las recomendaciones de OWASP

Última actualización: 29 de marzo de 2025