dazeb/markdown-downloader

## 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:
bash
npx -y @smithery/cli install @dazeb/markdown-downloader --client claude
### Installing manually
1. Clone the repository:
bash
git clone https://github.com/your-username/markdown-downloader.git
cd markdown-downloader
2. Install dependencies:
bash
npm install
3. Build the project:
bash
npm run build
## Manually Add Server to Cline/Roo-Cline MCP Settings file
### Linux/macOS
json
"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
json
"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:
bash
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:
bash
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:
bash
use list_downloaded_files
### 4. Get Download Directory
Retrieve the current download directory:
bash
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