Download MCP 工具 について
MCP ベースのインテリジェントダウンロードツール。AI アシスタントがマルチスレッド下載タスクを管理し、自然言語コマンドで再開、永続化、進捗監視に対応します。
主な機能
- 01最大 32 スレッドの並列ダウンロード
- 02再開とスマート再試行
- 03タスク永続化とバックグラウンド実行
- 04リアルタイム進捗と速度監視
- 05タスク管理の完全なインターフェース
- 06ブロッキングと非ブロッキングモード
活用シーン
- 01AI アシスタントで自然言語によるファイルダウンロード
- 02大容量ファイルの高速ダウンロードと再開
- 03バックグラウンドダウンロードタスク管理
- 04コーディングツールへのインテリジェントダウンロード統合
MCP 対応
この MCP サーバーはダウンロードツールをクライアントに公開し、AI モデルが標準化されたインターフェースを通じてファイルダウンロード、タスク管理、進捗監視を実行できます。
詳細
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"
]
}
}
}
⚠️ ご注意:
ユーザー名をお使いの Linux ユーザー名に置き換えてください- パスがクローンまたは解凍したプロジェクトディレクトリを正しく指してください
- パスはプロジェクトファイルを配置した実際の場所を反映してください
- クローンまたは解凍したフォルダを削除しないでください。これにより MCP が正常に機能しなくなります
4. サービスを開始
設定後、Cursor エディターを再起動すると、MCP サービスが自動的に起動します。その後、使い始めることができます。
使用例 (クリックして展開)
AI に以下の操作を実行するよう指示できます:
- 「https://nodejs.org/dist/v18.19.0/node-v18.19.0-x64.msi をダウンロードフォルダにダウンロード」
- 「現在のすべてのダウンロードタスクを表示」
- 「ダウンロード ID が abc123 のダウンロード状態を確認」
- 「現在のダウンロードタスクを一時停止」
- 「ID が abc123 のダウンロードを再開し、8 スレッド使用」
- 「進行中のダウンロードをキャンセル」
- 「すべての完了したダウンロードタスクをクリーンアップ」
高度な使用方法:
- 「32 スレッドを使用して https://dlcdn.apache.org/tomcat/tomcat-10/v10.1.19/bin/apache-tomcat-10.1.19.zip をダウンロード」
- 「ブロッキングモードで https://dl.google.com/android/repository/platform-tools-latest-windows.zip をダウンロード」(ダウンロード完了後に続行)
- 「https://repo.anaconda.com/archive/Anaconda3-2023.09-0-Windows-x86_64.exe の永続化ダウンロードを開始」(フォアグラウンドプログラムを閉じてもダウンロード継続)
技术实现细节 (点击展开)
本工具基于 MCP (Model Context Protocol) 标准实现,作为 AI 模型与文件下载服务之间的桥梁。它使用 node-fetch 作为底层下载客户端,并通过 Zod 进行请求验证和类型检查。
主要技术组件包括:
- 多线程下载管理器:将大文件分割为多个段,并发下载,然后合并
- 断点续传系统:跟踪每个段的下载进度,支持中断后恢复
- 持久化存储:保存下载任务状态,即使程序重启也能恢复
- 实时监控:计算下载速度、预估剩余时间等关键指标
- 灵活的工作模式:支持阻塞/非阻塞、持久化/非持久化模式
每个下载操作都被封装为标准化的 MCP 工具,接收结构化参数并返回格式化结果。所有下载任务都作为独立进程管理,确保即使前台程序关闭,下载也能安全继续。
这种设计使 AI 模型能够清晰地理解和处理下载状态,并以更自然的方式与用户沟通下载进度、速度和其他关键信息。
许可证
ISC
如果这个项目对你有帮助,欢迎给个 Star ⭐️ (。♥‿♥。)
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。