What is Markdown Downloader

Markdown Downloader is a powerful MCP Server that enables users to download any webpage as a markdown file instantly. It utilizes the r.jina.ai service to convert web content into markdown format seamlessly.

Use cases

Markdown Downloader is ideal for developers and writers who need to quickly save web content for reference, documentation, or further editing in markdown format directly in their IDE.

How to use

To use Markdown Downloader, first clone the repository and install the necessary dependencies. Configure the MCP settings to add the server. You can set the download directory, download markdown files from URLs, list downloaded files, and retrieve the current download directory using specific commands.

Key features

Key features include the ability to download webpages as markdown using r.jina.ai, configurable download directory, automatic date-stamped filenames, listing of downloaded markdown files, and persistent configuration.

Where to use

undefined

Markdown Downloader MCP Server

Overview

Markdown Downloader is a powerful MCP (Model Context Protocol) server that allows you to download webpages as markdown files with ease. Leveraging the r.jina.ai service, this tool provides a seamless way to convert web content into markdown format.

Features

• 🌐 Download webpages as markdown using r.jina.ai
• 📁 Configurable download directory
• 📝 Automatically generates date-stamped filenames
• 🔍 List downloaded markdown files
• 💾 Persistent configuration

Prerequisites

• Node.js (version 16 or higher)
• npm (Node Package Manager)

Installation

Installing via Smithery

To install Markdown Downloader for Claude Desktop automatically via Smithery:

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

Installing manually

1. Clone the repository:

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

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Manually Add Server to Cline/Roo-Cline MCP Settings file

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"
      ]
    }
  }
}

Tools and Usage

1. Set Download Directory

Change the download directory:

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

• Validates directory exists and is writable
• Persists the configuration for future use

2. Download Markdown

Download a webpage as a markdown file:

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

• The URL will be prepended with r.jina.ai
• Filename format: {sanitized-url}-{date}.md
• Saved in the configured download directory

3. List Downloaded Files

List all downloaded markdown files:

use list_downloaded_files

4. Get Download Directory

Retrieve the current download directory:

use get_download_directory

Configuration

Linux/macOS

• Configuration is stored in ~/.config/markdown-downloader/config.json
• Default download directory: ~/.markdown-downloads

Windows

• Configuration is stored in %APPDATA%\markdown-downloader\config.json
• Default download directory: %USERPROFILE%\Documents\markdown-downloads

Troubleshooting

• Ensure you have an active internet connection
• Check that the URL is valid and accessible
• Verify write permissions for the download directory

Security

• The tool uses r.jina.ai to fetch markdown content
• Local files are saved with sanitized filenames
• Configurable download directory allows flexibility

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Disclaimer

This tool is provided as-is. Always review downloaded content for accuracy and appropriateness.

Support

For issues or feature requests, please open an issue on the GitHub repository.