DDM đi kèm máy chủ MCP, dannexdownloadmanager-mcp, cho phép trợ lý AI hỗ trợ MCP (Claude Desktop, Claude Code, Cursor, VS Code và các ứng dụng khác) thao tác với các mục tải xuống trong DDM đang chạy. Bạn có thể yêu cầu bằng lời của mình:
- "DDM đang tải xuống những gì và còn bao lâu nữa?"
- “Tải https://example.com/big.iso xuống D:\ISOs tối nay, nhưng chưa bắt đầu tải.”
- "Tạm dừng tất cả những gì đang tải xuống."
- "Xóa các bản tải xuống đã hoàn tất khỏi danh sách nhưng giữ lại các tệp."
Trợ lý tự khởi động máy chủ; bạn chỉ cần cho trợ lý biết vị trí của máy chủ một lần. Máy chủ chuyển từng yêu cầu đến ứng dụng thông qua API tự động hóa, chỉ trên máy tính này.
Trợ lý có thể làm gì
| Công cụ | Chức năng |
|---|---|
list_downloads |
Liệt kê các mục tải xuống của bạn, theo thứ tự mới nhất trước: tệp, địa chỉ, thư mục, trạng thái, kích thước, tiến độ và tốc độ. Có thể chỉ liệt kê các mục ở một trạng thái (Đang chờ, Đang tải xuống, Đã dừng, Hoàn tất, Lỗi), hoặc chỉ liệt kê tên và địa chỉ có chứa văn bản cụ thể. |
add_download |
Thêm địa chỉ http, https, ftp hoặc ftps rồi bắt đầu tải xuống, hoặc chỉ xếp vào hàng đợi. Có thể chỉ định thư mục và tên tệp cần dùng. Liên kết magnet sẽ mở Thêm torrent trong DDM để bạn chọn tệp. |
pause_downloads |
Tạm dừng các bản tải xuống đang chạy. |
resume_downloads |
Bắt đầu hoặc tiếp tục tải xuống các mục đã dừng, đang chờ hoặc bị lỗi. |
remove_downloads |
Xóa các mục tải xuống khỏi danh sách nhưng giữ lại tệp, hoặc xóa cả tệp nếu được yêu cầu. Phải tạm dừng mục đang tải xuống trước khi xóa. |
start_queue |
Bắt đầu hàng đợi tải xuống chính. |
Trợ lý không thể thay đổi tùy chọn của DDM, xem trình duyệt của bạn hoặc tự bật API tự động hóa.
Thiết lập
1. Bật API tự động hóa
Để liệt kê và thao tác với các mục tải xuống, cần bật API tự động hóa của DDM. API này mặc định tắt. Khi DDM đang chạy, hãy chạy lệnh này một lần (API sẽ tiếp tục bật):
dannexdownloadmanager-cli api on
dannexdownloadmanager-cli api offđể tắt API. Không có API, trợ lý vẫn có thể thêm mục tải xuống như dòng lệnh của DDM.
2. Tìm máy chủ
dannexdownloadmanager-mcpnằm cạnh ứng dụng:
| Bạn đã cài đặt | Máy chủ |
|---|---|
| Windows, chỉ cài đặt cho bạn (mặc định của trình cài đặt) | %LOCALAPPDATA%\Programs\Dannex Download Manager\dannexdownloadmanager-mcp.exe |
| Windows, cài đặt cho mọi người | C:\Program Files\Dannex Download Manager\dannexdownloadmanager-mcp.exe |
| Windows, tệp zip hoặc bản portable | dannexdownloadmanager-mcp.exetrong thư mục chứa ứng dụng |
| macOS | /Applications/Dannex Download Manager.app/Contents/MacOS/dannexdownloadmanager-mcp |
| Linux, tệp .deb hoặc .rpm | /usr/bin/dannexdownloadmanager-mcp |
| Linux, tệp .tar.gz | dannexdownloadmanager-mcptrong thư mục của nó (AppImage không hiển thị: hãy dùng .tar.gz) |
Máy chủ của bản sao di động tự tìm DDM của bản sao di động từ thư mục của nó.
3. Cho trợ lý biết
Claude Desktop: Cài đặt → Nhà phát triển → Sửa cấu hình mở claude_desktop_config.json. Thêm máy chủ, sau đó khởi động lại 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: mục mcpServers giống như của Claude Desktop, trong ~/.cursor/mcp.json (hoặc thêm vào trong cài đặt MCP của Cursor).
VS Code: trong .vscode/mcp.json, hoặc MCP: Thêm máy chủ trong bảng lệnh:
{
"servers": {
"dannexdownloadmanager": {
"type": "stdio",
"command": "C:\\Users\\you\\AppData\\Local\\Programs\\Dannex Download Manager\\dannexdownloadmanager-mcp.exe"
}
}
}
Dùng đường dẫn từ bước 2 (trong JSON, mỗi \ được viết \\). Các trợ lý khác cũng dùng tương tự: một lệnh để khởi động, không có đối số.
Quyền riêng tư
Bản thân DDM không gửi dữ liệu đi đâu cả: máy chủ chỉ giao tiếp với DDM trên máy tính này qua kênh cục bộ được bảo vệ bằng mã thông báo. Nhưng trợ lý sẽ chuyển những gì nó đọc được đến dịch vụ AI của mình. Khi liệt kê các bản tải xuống, trợ lý sẽ gửi tên tệp, địa chỉ và thư mục của chúng đến dịch vụ đó, theo các điều khoản bảo mật của dịch vụ. Tắt API tự động hóa hoặc xóa máy chủ khỏi trợ lý nếu bạn không muốn điều đó.
Khi gặp sự cố
| Thông báo của trợ lý | Cách xử lý |
|---|---|
| Dannex Download Manager chưa chạy | Khởi động DDM. Máy chủ không thể tự khởi động DDM. |
| API tự động hóa đang tắt | Chạy dannexdownloadmanager-cli api on khi DDM đang chạy. |
| DDM không phản hồi kịp | Một cửa sổ trong DDM có thể đang chờ bạn (một câu hỏi, Thêm torrent); hãy trả lời và hỏi lại. |
| DDM đã từ chối yêu cầu | Tệp kênh của DDM là từ lần khởi động trước; hãy khởi động lại DDM. |
| Không thấy công cụ nào | Kiểm tra đường dẫn trong cài đặt của trợ lý rồi khởi động lại trợ lý. Khi khởi chạy thủ công, dannexdownloadmanager-mcp --help sẽ cho biết chức năng của nó. |
Miễn phí, mã nguồn mở, không quảng cáo, không dùng thử.
Tải xuống Dannex Download Manager