Download MCP 工具

Created By

shuakamia year ago

📥 MCP Download Tool - AI-powered file download manager | 基于 MCP 的智能下载管理工具

# nodejs

# typescript

Overview Content Comments

Content

Download MCP 工具

English Version (README-EN.md)

这是什么

这是一个基于 MCP (Model Context Protocol) 的下载工具，它能让 AI 模型通过标准化接口管理文件下载任务。

简单来说，它让 AI 助手能够执行各种下载操作，如启动多线程下载、监控下载进度、管理下载任务等，无需用户手动输入复杂的命令或切换到其他下载工具。

支持的功能 (点击展开)

下载文件：自动创建多线程下载任务，支持断点续传
任务管理：列出、获取、暂停、恢复、取消和清理下载任务
多线程下载：支持多达32线程并行下载，显著提升下载速度
持久化功能：下载任务可在后台持续运行，即使关闭前台程序
状态监控：实时跟踪下载进度、速度和耗时
灵活配置：支持阻塞/非阻塞、持久化/非持久化等多种模式

功能特点 (点击展开)

以下是 Download MCP 工具的一些核心特点：

极速多线程下载：最高支持32线程并行下载，大幅提升下载速度
智能断点续传：自动检测中断的下载并从断点处继续
持久化下载任务：即使关闭前台进程，下载任务也会在后台继续
实时状态监控：提供下载速度、进度、剩余时间等实时信息
灵活的工作模式：支持阻塞式或非阻塞式下载，根据需求选择
完整的任务管理：创建、暂停、恢复、取消和清理下载任务的全流程管理
智能错误处理：自动重试失败的下载，确保下载成功率

通过简单的自然语言指令，AI 可以帮助你完成上述所有操作，无需手动编写复杂命令或使用专门的下载软件。

快速上手

0. 环境准备

如果你之前没有使用过 Node.js (点击展开)

安装 Node.js 和 npm
- 访问 Node.js 官网
- 下载并安装 LTS（长期支持）版本
- 安装时选择默认选项即可，安装包会同时安装 Node.js 和 npm
验证安装
- 安装完成后，打开命令提示符（CMD）或 PowerShell
- 输入以下命令确认安装成功：
```
node --version
npm --version
```
- 如果显示版本号，则表示安装成功
安装 Git（如果尚未安装）
- 访问 Git 官网
- 下载并安装 Git
- 安装时使用默认选项即可
安装 Python 3.11 或更高版本（必需）
- 访问 Python 官网
- 下载并安装 Python 3.11 或更高版本
- 重要：安装时必须勾选"Add Python to PATH"选项
- 安装完成后重启电脑，确保环境变量生效

1. 克隆并安装

git clone https://github.com/shuakami/mcp-download.git
cd mcp-download
npm install
npm run build

2. 构建项目

npm run build

3. 添加到 Cursor MCP 配置

根据你的操作系统，按照以下步骤配置 MCP：

Windows 配置 (点击展开)

在 Cursor 中，打开或创建 MCP 配置文件：C:\\Users\\你的用户名\\.cursor\\mcp.json
- 注意：请将 你的用户名 替换为你的 Windows 用户名
添加或修改配置如下：

{
  "mcpServers": {
    "download-mcp": {
      "command": "python",
      "args": [
        "C:/Users/你的用户名/mcp-download/bridging_download_mcp.py"
      ]
    }
  }
}

⚠️ 请注意:

将 你的用户名 替换为你的 Windows 用户名

确保路径正确指向你克隆或解压的项目目录

路径应该反映你将项目文件放置的实际位置

不要删除克隆或解压的文件夹，这会导致 MCP 无法正常工作

macOS 配置 (点击展开)

在 Cursor 中，打开或创建 MCP 配置文件：/Users/你的用户名/.cursor/mcp.json
- 注意：请将 你的用户名 替换为你的 macOS 用户名
添加或修改配置如下：

{
  "mcpServers": {
    "download-mcp": {
      "command": "python3",
      "args": [
        "/Users/你的用户名/mcp-download/bridging_download_mcp.py"
      ]
    }
  }
}

⚠️ 请注意:

将 你的用户名 替换为你的 macOS 用户名

确保路径正确指向你克隆或解压的项目目录

路径应该反映你将项目文件放置的实际位置

不要删除克隆或解压的文件夹，这会导致 MCP 无法正常工作

Linux 配置 (点击展开)

在 Cursor 中，打开或创建 MCP 配置文件：/home/你的用户名/.cursor/mcp.json
- 注意：请将 你的用户名 替换为你的 Linux 用户名
添加或修改配置如下：

{
  "mcpServers": {
    "download-mcp": {
      "command": "python3",
      "args": [
        "/home/你的用户名/mcp-download/bridging_download_mcp.py"
      ]
    }
  }
}