Markdown Downloader MCP Server

Markdown Downloader MCP 服务

概述

Markdown Downloader 是一款功能强大的 MCP（Model Context Protocol）服务，可轻松将网页下载为 Markdown 文件。借助 r.jina.ai 服务，此工具可无缝地将网页内容转换为 Markdown 格式。

功能

• 🌐 使用 r.jina.ai 将网页下载为 Markdown
• 📁 可配置下载目录
• 📝 自动生成带日期的文件名
• 🔍 列出已下载的 Markdown 文件
• 💾 持久化配置

前提条件

• Node.js（版本 16 或更高）
• npm（Node Package Manager）

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 Markdown Downloader：

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

手动安装

1. 克隆仓库：

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

2. 安装依赖：

   npm install
   

3. 构建项目：

   npm run build
   

手动将服务添加到 Cline/Roo-Cline MCP 设置文件

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

工具和用法

1. 设置下载目录

更改下载目录：

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

• 验证目录是否存在且可写
• 保存配置以供后续使用

2. 下载 Markdown

将网页下载为 Markdown 文件：

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

• URL 前会添加 r.jina.ai
• 文件名格式：{sanitized-url}-{date}.md
• 保存到已配置的下载目录中

3. 列出已下载的文件

列出所有已下载的 Markdown 文件：

use list_downloaded_files

4. 获取下载目录

获取当前下载目录：

use get_download_directory

配置

Linux/macOS

• 配置存储在 ~/.config/markdown-downloader/config.json
• 默认下载目录：~/.markdown-downloads

Windows

• 配置存储在 %APPDATA%\markdown-downloader\config.json
• 默认下载目录：%USERPROFILE%\Documents\markdown-downloads

故障排除

• 确保网络连接正常
• 检查 URL 是否有效且可访问
• 确认下载目录具有写入权限

安全性

• 此工具使用 r.jina.ai 获取 Markdown 内容
• 本地文件使用经过清理的文件名保存
• 可配置的下载目录提供了灵活性

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

免责声明

此工具按原样提供。请务必检查下载内容的准确性和适用性。

支持

如有问题或功能请求，请在 GitHub 仓库中提交 issue。