# zerx-lab/FluxDown [Health: Active]

**Category:** 🛠️ Other Tools and Integrations  
**Repository:** https://github.com/zerx-lab/FluxDown  
**GitHub Stars:** 5065  
**Views:** 12  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/zerx-lab-fluxdown

## Description
Control the FluxDown multi-protocol download manager (HTTP/FTP/BitTorrent/HLS): add, list, pause, resume, remove downloads and manage queues.

## Tools
Capabilities this server exposes over MCP:

- **download_add** — Create a download task (HTTP/HTTPS, FTP, magnet, BitTorrent)
- **download_list** — List tasks with progress/speed/status, optional status filter
- **download_get** — Get a single task by ID
- **download_pause** — Pause / resume one task
- **download_pause_all** — Pause / resume all tasks
- **download_remove** — Remove a task, optionally deleting downloaded files
- **queue_list** — List named queues and their configuration
- **rss_list** — List RSS subscriptions with their configuration and runtime state
- **rss_add** — Subscribe to an RSS feed and start polling it on a schedule
- **rss_remove** — Delete an RSS subscription and the items it collected

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "fluxdown": {
    "url": "http://127.0.0.1:17800/mcp"
  }
}
```

## Documentation

## What zerx-lab/FluxDown MCP server does

zerx-lab/FluxDown connects an MCP client to the FluxDown download manager. It gives an agent controls for creating download tasks, checking their progress, changing task state, and deleting tasks. Supported task inputs include HTTP and HTTPS URLs, FTP locations, magnet links, and BitTorrent downloads. FluxDown itself also supports eD2K, HLS, and DASH through its broader download engine.

The MCP interface also exposes operational information around downloads. An agent can inspect named queues and their configuration, list RSS subscriptions, create a feed subscription with scheduled polling, or remove a subscription together with the items it collected.

## How it works

FluxDown uses a Rust and Tokio download engine with persisted task state. Its broader deployments use SQLite with WAL by default, while server deployments can use PostgreSQL. Persisted state allows downloads to recover and resume after interruption.

The MCP layer is part of FluxDown’s built-in automation and API surface. FluxDown can run as a desktop application, a headless server, or a containerized service, with the same download engine shared across its clients. The server-side distribution includes `fluxdown-agent --server` and `fluxdownd`, plus an embedded web interface.

## Setup and configuration

Install the latest FluxDown build from GitHub Releases or fluxdown.com, or use the server distribution for a headless deployment. The project provides packages for Windows, macOS, Linux, Android, and several NAS environments, as well as a Docker image named `ghcr.io/zerx-lab/fluxdown-server`.

For a Docker deployment, the supplied Compose configuration starts the service with:

```shell
docker compose -f docker/docker-compose.yml up -d
```

The default server address is `0.0.0.0:17800`, and the web interface is available at `http://<server>:17800/`. Configure an access key during first-run setup before exposing the service. The key must be 8–128 visible ASCII characters and include at least one letter and one digit. For unattended initialization, `FLUXDOWN_TOKEN` can be supplied through the deployment environment or a secret manager; it initializes the key only when one has not already been configured. `FLUXDOWN_BIND` changes the bind address.

Persist `/data` for the database, logs, and access key, and persist `/root/Downloads` for downloaded files. Use an HTTPS reverse proxy for remote access and keep the service on a trusted network during initial setup.

## Tools and capabilities

- `download_add` creates HTTP/HTTPS, FTP, magnet, or BitTorrent tasks.
- `download_list` returns task progress, speed, and status, with an optional status filter.
- `download_get` retrieves one task by ID.
- `download_pause` pauses or resumes one task.
- `download_pause_all` pauses or resumes all tasks.
- `download_remove` removes a task and can optionally delete its downloaded files.
- `queue_list` reports named queues and their configuration.
- `rss_list` reports RSS subscriptions, configuration, and runtime state.
- `rss_add` subscribes to an RSS feed and starts scheduled polling.
- `rss_remove` deletes a subscription and the items it collected.

## Limitations and notes

Removing a task can also delete its downloaded files, so agents should treat that option as destructive. RSS subscriptions can collect items automatically according to their polling schedule. FluxDown’s local downloads do not require a FluxCloud account, but the application can send anonymous installation and daily-active statistics unless analytics are disabled with `analytics_enabled`. Download and task information is not included in that telemetry.

_Full upstream README: https://allmcps.com/mcp/zerx-lab-fluxdown/readme_