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.

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