Dannex Download Manager
  1. خانه
  2. راهنما
  3. دستیاران هوش مصنوعی (MCP)

دستیاران هوش مصنوعی (MCP)

DDM همراه با سرور MCP ارائه می‌شودdannexdownloadmanager-mcp؛ بنابراین دستیار هوش مصنوعی‌ای که از MCP پشتیبانی می‌کند (Claude Desktop، Claude Code، Cursor، VS Code و ابزارهای دیگر) می‌تواند با بارگیری‌های DDM در حال اجرا کار کند. کافی است درخواستتان را با زبان خودتان بنویسید:

  • «DDM الان چه چیزی را بارگیری می‌کند و چقدر زمان باقی مانده است؟»
  • «امشب https://example.com/big.iso را در D:\ISOs بارگیری کن، اما هنوز بارگیری را شروع نکن.»
  • «مکث همه بارگیری‌های در حال انجام.»
  • «بارگیری‌های تمام شده را از لیست حذف کن اما فایل‌ها را نگه دار.»

دستیار خودش سرور را راه‌اندازی می‌کند؛ شما فقط یک بار به دستیار می‌گویید که کجاست. سرور هر درخواست را از طریق API اتوماسیون خود، فقط در همین رایانه، به برنامه ارسال می‌کند.

دستیار چه کارهایی می‌تواند انجام دهد

ابزار آنچه انجام می‌دهد
list_downloads بارگیری‌ها را به‌ترتیب جدیدترین فهرست می‌کند و اطلاعات فایل، نشانی، پوشه، وضعیت، اندازه، میزان پیشرفت و سرعت را نشان می‌دهد. می‌تواند فقط بارگیری‌های دارای یک وضعیت مشخص (در صف، در حال بارگیری، متوقف‌شده، کامل، خطا) یا فقط نام‌ها و نشانی‌هایی را فهرست کند که شامل متنی مشخص هستند.
add_download نشانی http، https، ftp یا ftps را اضافه و بارگیری آن را آغاز می‌کند یا فقط آن را در صف می‌گذارد. می‌تواند پوشه و نام فایلی را که باید استفاده شود مشخص کند. با پیوند مگنت، پنجره افزودن تورنت در DDM باز می‌شود تا فایل‌ها را انتخاب کنید.
pause_downloads بارگیری‌های در حال اجرا را مکث می‌کند.
resume_downloads بارگیری‌های متوقف‌شده، در صف یا ناموفق را آغاز می‌کند یا از سر می‌گیرد.
remove_downloads بارگیری‌ها را از فهرست حذف می‌کند و فایل‌هایشان را نگه می‌دارد؛ در صورت درخواست، فایل‌ها را هم حذف می‌کند. ابتدا باید بارگیری در حال اجرا را متوقف کرد.
start_queue صف اصلی بارگیری را شروع می‌کند.

دستیار نمی‌تواند گزینه‌های DDM را تغییر دهد، مرورگرتان را ببیند یا خودش API خودکارسازی را روشن کند.

تنظیم

1. روشن کردن API خودکارسازی

برای فهرست کردن بارگیری‌ها و انجام کار روی آن‌ها، به API خودکارسازی DDM نیاز است. این API تا وقتی روشنش نکنید، خاموش است. وقتی DDM در حال اجراست، این فرمان را یک بار اجرا کنید (روشن می‌ماند):

dannexdownloadmanager-cli api on

dannexdownloadmanager-cli api offاین فرمان API را دوباره خاموش می‌کند. بدون API، دستیار همچنان می‌تواند بارگیری‌ها را اضافه کند؛ مانند خط فرمان DDM.

2. یافتن سرور

dannexdownloadmanager-mcpکنار برنامه است:

شما نصب کردید سرور
Windows، فقط برای شما (پیش‌فرض نصب‌کننده) %LOCALAPPDATA%\Programs\Dannex Download Manager\dannexdownloadmanager-mcp.exe
Windows، برای همه C:\Program Files\Dannex Download Manager\dannexdownloadmanager-mcp.exe
Windows، یک فایل فشرده یا نسخه قابل حمل dannexdownloadmanager-mcp.exeدر پوشه آن
macOS /Applications/Dannex Download Manager.app/Contents/MacOS/dannexdownloadmanager-mcp
Linux، فایل .deb یا .rpm /usr/bin/dannexdownloadmanager-mcp
Linux، فایل .tar.gz dannexdownloadmanager-mcpدر پوشه خود (AppImage آن را نشان نمی‌دهد: از .tar.gz استفاده کنید)

سرور نسخه قابل‌حمل، نسخه قابل‌حمل DDM را به‌طور خودکار از پوشه خودش پیدا می‌کند.

3. به دستیار خود بگویید

Claude Desktop: با انتخاب تنظیمات → توسعه‌دهنده → ویرایش پیکربندی، claude_desktop_config.json باز می‌شود. سرور را اضافه کنید و سپس Claude Desktop را دوباره راه‌اندازی کنید:

{
  "mcpServers": {
    "dannexdownloadmanager": {
      "command": "C:\\Users\\you\\AppData\\Local\\Programs\\Dannex Download Manager\\dannexdownloadmanager-mcp.exe"
    }
  }
}

Claude Code:

claude mcp add dannexdownloadmanager -- "C:\Users\you\AppData\Local\Programs\Dannex Download Manager\dannexdownloadmanager-mcp.exe"

Cursor: همان ورودی mcpServers Claude Desktop، در ~/.cursor/mcp.json (یا آن را در تنظیمات MCP Cursor اضافه کنید).

VS Code: در .vscode/mcp.json یا با انتخاب MCP: افزودن سرور از پالت فرمان:

{
  "servers": {
    "dannexdownloadmanager": {
      "type": "stdio",
      "command": "C:\\Users\\you\\AppData\\Local\\Programs\\Dannex Download Manager\\dannexdownloadmanager-mcp.exe"
    }
  }
}

از مسیری که در مرحله 2 به دست آوردید استفاده کنید (در JSON، هر \ به شکل \\ نوشته می‌شود). سایر دستیارها هم همین اطلاعات را می‌خواهند: فرمانی برای شروع، بدون آرگومان.

حریم خصوصی

خود DDM همچنان چیزی را به جایی نمی‌فرستد: سرور فقط از طریق کانال محلی محافظت‌شده با توکن، با DDM روی همین رایانه ارتباط برقرار می‌کند. اما دستیار هر چیزی را که می‌خواند، به سرویس هوش مصنوعی خودش می‌فرستد. وقتی فهرست بارگیری‌های شما را می‌گیرد، نام فایل‌ها، نشانی‌ها و پوشه‌های آن‌ها نیز طبق شرایط حریم خصوصی آن سرویس به آن فرستاده می‌شوند. اگر نمی‌خواهید این اتفاق بیفتد، API اتوماسیون را خاموش کنید یا سرور را از دستیار حذف کنید.

وقتی کار نمی‌کند

دستیار می‌گوید چه باید کرد
Dannex Download Manager در حال اجرا نیست DDM را اجرا کنید. سرور نمی‌تواند آن را برای شما اجرا کند.
API اتوماسیون خاموش است dannexdownloadmanager-cli api on را هنگامی اجرا کنید که DDM در حال اجراست.
DDM به‌موقع پاسخ نداد ممکن است پنجره‌ای در DDM منتظر پاسخ شما باشد (مثلا پرسشی درباره افزودن تورنت)؛ به آن پاسخ دهید و دوباره درخواست را بفرستید.
DDM درخواست را نپذیرفت فایل کانال DDM مربوط به اجرای قبلی است؛ DDM را دوباره راه‌اندازی کنید.
ابزارها اصلا نمایش داده نمی‌شوند مسیر را در تنظیمات دستیار بررسی کنید و دستیار را دوباره راه‌اندازی کنید. اگر dannexdownloadmanager-mcp --help را دستی اجرا کنید، می‌گوید چیست.

رایگان، متن‌باز، بدون تبلیغات، بدون دوره آزمایشی.

بارگیری Dannex Download Manager