Skip to main content
Glama
Markdown Downloader

Markdown Downloader

by dazeb
README.md
[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/dazeb-markdown-downloader-badge.jpg)](https://mseep.ai/app/dazeb-markdown-downloader)
[![MseeP Badge](https://mseep.net/pr/dazeb-markdown-downloader-badge.jpg)](https://mseep.ai/app/dazeb-markdown-downloader)

[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/e85a9805-464e-46bd-a953-ccac0c4a5129)

# Markdown Downloader MCP Server

[![smithery badge](https://smithery.ai/badge/@dazeb/markdown-downloader)](https://smithery.ai/server/@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.

<a href="https://glama.ai/mcp/servers/jrki7zltg7">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/jrki7zltg7/badge" alt="Markdown Downloader MCP server" />
</a>

## 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](https://smithery.ai/server/@dazeb/markdown-downloader):

```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

- 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.

TDQS

A3.5/5.0

Scored across 5 tools

Disambiguation5/5

Each tool has a clearly distinct purpose with no overlap. create_subdirectory handles folder creation, download_markdown performs the core download function, get_download_directory and set_download_directory manage configuration, and list_downloaded_files provides file enumeration. An agent can easily distinguish between these operations.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern with clear, descriptive names. The naming convention is uniform throughout (e.g., create_subdirectory, download_markdown, get_download_directory), making the tool set predictable and easy to understand.

Tool Count5/5

With 5 tools, this server is well-scoped for its purpose of downloading and managing markdown files. Each tool serves a specific, necessary function without redundancy, making the count appropriate and efficient for the domain.

Completeness4/5

The tool set covers the core workflows of downloading, listing, and managing directories for markdown files. A minor gap exists in operations like updating or deleting downloaded files, but agents can work around this, and the surface is largely complete for the stated purpose.

Maintenance

ActivityInactive
ResponsivenessLimited data