Markdown Downloader

Servidor MCP de Markdown Downloader

Descripción general

Markdown Downloader es un potente servidor MCP (Model Context Protocol) que te permite descargar páginas web como archivos markdown con facilidad. Aprovechando el servicio r.jina.ai, esta herramienta proporciona una forma fluida de convertir contenido web al formato markdown.

Características

• 🌐 Descarga páginas web como markdown usando r.jina.ai
• 📁 Directorio de descarga configurable
• 📝 Genera automáticamente nombres de archivo con fecha
• 🔍 Lista los archivos markdown descargados
• 💾 Configuración persistente

Requisitos previos

• Node.js (versión 16 o superior)
• npm (Node Package Manager)

Instalación

Instalación mediante Smithery

Para instalar Markdown Downloader para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @dazeb/markdown-downloader --client claude

Instalación manual

1. Clona el repositorio:

   git clone https://github.com/your-username/markdown-downloader.git
   cd markdown-downloader
   

2. Instala las dependencias:

   npm install
   

3. Compila el proyecto:

   npm run build
   

Añadir manualmente el servidor al archivo de configuración MCP de Cline/Roo-Cline

Linux/macOS

{
  "mcpServers": {
    "markdown-downloader": {
      "command": "node",
      "args": [
        "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
      ],
      "disabled": false,
      "alwaysAllow": [
        "download_markdown",
        "set_download_directory"
      ]
    }
  }
}

Windows

{
  "mcpServers": {
    "markdown-downloader": {
      "command": "node",
      "args": [
        "C:\\Users\\username\\Documents\\Cline\\MCP\\markdown-downloader\\build\\index.js"
      ],
      "disabled": false,
      "alwaysAllow": [
        "download_markdown",
        "set_download_directory"
      ]
    }
  }
}

Herramientas y uso

1. Establecer directorio de descarga

Cambia el directorio de descarga:

use set_download_directory /path/to/your/local/download/folder

• Valida que el directorio exista y sea escribible
• Persiste la configuración para uso futuro

2. Descargar markdown

Descarga una página web como archivo markdown:

use tool download_markdown https://example.com/blog-post

• La URL se antepondrá con r.jina.ai
• Formato del nombre de archivo: {sanitized-url}-{date}.md
• Se guarda en el directorio de descarga configurado

3. Listar archivos descargados

Lista todos los archivos markdown descargados:

use list_downloaded_files

4. Obtener directorio de descarga

Recupera el directorio de descarga actual:

use get_download_directory

Configuración

Linux/macOS

• La configuración se almacena en ~/.config/markdown-downloader/config.json
• Directorio de descarga predeterminado: ~/.markdown-downloads

Windows

• La configuración se almacena en %APPDATA%\markdown-downloader\config.json
• Directorio de descarga predeterminado: %USERPROFILE%\Documents\markdown-downloads

Solución de problemas

• Asegúrate de tener una conexión a internet activa
• Comprueba que la URL sea válida y accesible
• Verifica los permisos de escritura para el directorio de descarga

Seguridad

• La herramienta utiliza r.jina.ai para obtener contenido markdown
• Los archivos locales se guardan con nombres de archivo saneados
• El directorio de descarga configurable permite flexibilidad

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una solicitud de extracción (Pull Request).

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

Aviso legal

Esta herramienta se proporciona tal cual. Siempre revisa el contenido descargado para verificar su precisión y adecuación.

Soporte

Para problemas o solicitudes de funciones, abre un issue en el repositorio de GitHub.