📌Overview

Purpose: To provide an efficient MCP server for downloading webpages as markdown files.

Overview: Markdown Downloader is a robust server that utilizes the r.jina.ai service to convert web content into markdown format effortlessly. It streamlines the process of saving and organizing markdown files by providing a user-friendly interface for managing downloads.

Key Features:

Webpage Downloading: Allows users to download webpages as markdown files, simplifying content management.
Configurable Settings: Users can configure the download directory to suit their preferences, ensuring flexibility in file organization.
Automatic File Naming: Automatically generates filenames that include a date stamp, making it easy to track content updates.
File Management: Includes functionality to list all downloaded markdown files, enhancing usability.
Persistent Configuration: Stores user settings persistently, reducing the need for repeated configuration.

Markdown Downloader MCP Server

Overview

Markdown Downloader is a powerful MCP (Model Context Protocol) server that enables users to download webpages as markdown files with ease, utilizing the r.jina.ai service.

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

Clone the repository:

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

Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

Configuration

Add the server to your Cline/Roo-Cline MCP settings file:

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

Tools and Usage

Set Download Directory

Change the download directory:

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

Download Markdown

Download a webpage as a markdown file:

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

List Downloaded Files

List all downloaded markdown files:

use list_downloaded_files

Get Download Directory

Retrieve the current download directory:

use get_download_directory

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 fetches markdown content from r.jina.ai
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.

Support

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