mcp-markdown-downloader v1.0.0

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
• 📁 Command-line configurable download directory
• 📝 Automatically generates date-stamped filenames
• 🔍 List downloaded markdown files
• 💾 Create and manage subdirectories

Prerequisites

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

Installation

You can use this server either locally or via npx.

Local Installation

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

NPX Installation

No local installation needed. Just add it to your MCP configuration as shown below.

Add Server to Cline/Roo-Cline MCP Settings

Using Local Installation

{
  "mcpServers": {
    "markdown-downloader": {
      "command": "node",
      "args": [
        "/path/to/your/markdown-downloader/build/index.js",
        "/path/to/your/download/directory"
      ],
      "disabled": false,
      "alwaysAllow": [
        "download_markdown",
        "list_downloaded_files",
        "get_download_directory",
        "create_subdirectory"
      ]
    }
  }
}

Using NPX

{
  "mcpServers": {
    "markdown-downloader": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-markdown-downloader",
        "/path/to/your/download/directory"
      ],
      "disabled": false,
      "alwaysAllow": [
        "download_markdown",
        "list_downloaded_files",
        "get_download_directory",
        "create_subdirectory"
      ]
    }
  }
}

Tools and Usage

1. Download Markdown

Download a webpage as a markdown file:

use 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

2. List Downloaded Files

List all downloaded markdown files:

use list_downloaded_files

3. Get Download Directory

Retrieve the current download directory:

use get_download_directory

4. Create Subdirectory

Create a new subdirectory in the root download folder:

use create_subdirectory my-subfolder

Troubleshooting

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

Security

• The tool uses r.jina.ai to fetch markdown content
• Local files are saved with sanitized filenames
• Directory path is validated at startup
• Write permissions are checked before server starts

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.