# Debrid-Link API v2 MCP Server

[![Traditional Chinese](https://img.shields.io/badge/lang-繁體中文-blue.svg)](README.zh-TW.md)

This is a Model Context Protocol (MCP) server that enables AI assistants (such as Claude Desktop, Cursor, Cline, etc.) to manage your Seedbox (torrents), Downloader (link unlocking/premium download links), and transcoding streams using the Debrid-Link API v2.

## Tools (Capabilities)

This server exposes the following tools to the AI client:

### Account & Limits
* `get_account_info`: Retrieve Debrid-Link account details (premium status, registered email, points, etc.).
* `get_seedbox_limits`: Fetch Seedbox storage and daily download limits/usage.
* `get_downloader_limits`: Fetch Downloader traffic quotas and usage per filehoster.

### Seedbox (Torrent Management)
* `list_torrents`: List torrents currently in your Seedbox.
* `get_torrents_activity`: Get a simplified/faster status of active torrents.
* `add_torrent`: Add a torrent via magnet link, torrent URL, or info hash.
* `remove_torrents`: Delete one or more torrents from the Seedbox (supports comma-separated IDs).
* `configure_torrent`: Exclude/select files for a waiting torrent (when `wait=true`).

### Downloader (Premium Link Generation)
* `list_downloader_links`: List unlocked download links.
* `add_downloader_link`: Unlock/decrypt a filehoster link (e.g. Mega, Rapidgator) to get a direct premium download URL.
* `remove_downloader_links`: Delete one or more unlocked links (supports comma-separated IDs).

### Files & Streaming
* `list_files`: List files and folders in a normalized file manager tree format.
* `create_transcode`: Create a live transcoding stream (HLS or MP4) for video files.
* `get_transcode_infos`: Retrieve status and URL of active transcodes.

---

## Installation & Setup

### 1. Get Your API Key
Go to [Debrid-Link API Key](https://debrid-link.com/webapp/apikey) and generate your **Private API key**.

### 2. Install Dependencies
```bash
npm install
# Note: If installing on virtual/cloud drives (e.g., Google Drive) that do not support symlinks, run:
# npm install --no-bin-links
```

### 3. Build the Project
```bash
npm run build
```

### 4. Configure Your MCP Client

#### Claude Desktop
Add this to your configuration file (usually at `%APPDATA%\Roaming\Claude\claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "debrid-link": {
      "command": "node",
      "args": ["/path/to/debrid-link-api-v2/dist/index.cjs"],
      "env": {
        "DEBRID_LINK_API_KEY": "YOUR_DEBRID_LINK_PRIVATE_API_KEY"
      }
    }
  }
}
```

#### Cline (VSCode Extension)
Add this to your configuration file (usually at `%APPDATA%\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`):

```json
{
  "mcpServers": {
    "debrid-link": {
      "command": "node",
      "args": ["/path/to/debrid-link-api-v2/dist/index.cjs"],
      "env": {
        "DEBRID_LINK_API_KEY": "YOUR_DEBRID_LINK_PRIVATE_API_KEY"
      },
      "disabled": false
    }
  }
}
```

---

## CLI Usage

This project also includes a CLI tool `dl-cli` to interact with Debrid-Link directly from your terminal.

### 1. Global Installation
Install the CLI globally on your system:
```bash
npm install -g .
```

### 2. Available Commands
Configure your `DEBRID_LINK_API_KEY` in your `.env` or export it to your environment, then run:

* **Account Status**:
  ```bash
  dl-cli status
  ```
* **Traffic & Limits**:
  ```bash
  dl-cli limits
  ```
* **Seedbox Management**:
  ```bash
  dl-cli torrent list                # List torrents
  dl-cli torrent add "magnet:..."    # Add magnet/torrent URL
  dl-cli torrent rm <torrent_ids>   # Delete torrent(s)
  ```
* **Link Unlocking (Downloader)**:
  ```bash
  dl-cli unlock "https://host.com/file..."
  ```

---

## Development & Local Testing

Create a `.env` file in the root directory:
```env
DEBRID_LINK_API_KEY=YOUR_DEBRID_LINK_PRIVATE_API_KEY
```

**Run in development mode:**
```bash
npm run dev
```

---

## License
This project is licensed under the [MIT License](LICENSE).