MoviePilot

https://wiki.movie-pilot.org
Admin
MoviePilot is an automation platform for media management and downloading, featuring intelligent...
Tokens:103,240
Snippets:512
Trust Score:6.7
Update:1 day ago
Show doc for...
Tokens:
Raw
### 服务管理命令

Source: https://wiki.movie-pilot.org/cli

统一管理本地前后端服务。start/stop/restart/status 管理服务；logs --frontend 查看前端启动日志；logs --stdio 查看后端启动标准输出；version 显示版本。通过系统内置重启入口触发重启时，如果当前实例是由 moviepilot start 管理起来的，本地安装模式也支持内建重启。

```shell
moviepilot start
moviepilot stop
moviepilot restart
moviepilot status
moviepilot logs
moviepilot logs --frontend
moviepilot logs --stdio
moviepilot version
```

--------------------------------

### 安全模式启动 moviepilot start --safe

Source: https://wiki.movie-pilot.org/doctor

以安全模式启动 MoviePilot，跳过插件加载、调度任务等，用于后端无法启动时恢复入口。

```shell
moviepilot start --safe
```

--------------------------------

### 指定配置目录安装

Source: https://wiki.movie-pilot.org/cli

使用 moviepilot setup 命令并指定 --config-dir 参数来手动设置配置目录，避免使用默认路径。

```shell
moviepilot setup --config-dir /path/to/moviepilot-config
```

--------------------------------

### Start PostgreSQL container with Docker

Source: https://wiki.movie-pilot.org/configuration

Runs a PostgreSQL container with the database name, user, and password set via environment variables. It is recommended to use a complex password and adjust port mappings, volume paths, and PostgreSQL version as needed.

```bash
docker run -d \
  --name postgresql \
  -p 5432:5432 \
  -e POSTGRES_DB=moviepilot \
  -e POSTGRES_USER=moviepilot \
  -e POSTGRES_PASSWORD="你的密码" \
  -v /volume1/docker/postgresql:/var/lib/postgresql/data \
  postgres
```

--------------------------------

### 分级帮助命令

Source: https://wiki.movie-pilot.org/cli

显示指定命令或子命令的帮助信息，例如 install、init、setup、update、agent、config、tool、scheduler 等。

```shell
moviepilot help install
moviepilot help init
moviepilot help setup
moviepilot help update
moviepilot help agent
moviepilot help config
moviepilot help config set
moviepilot help tool
moviepilot help scheduler
```

--------------------------------

### GET /api/v1/mcp/tools

Source: https://wiki.movie-pilot.org/mcp

Lists all available MCP tools exposed by the current MoviePilot instance. The tool list may vary by version and installed plugins.

```APIDOC
## GET /api/v1/mcp/tools

### Description
Lists all available MCP tools exposed by the current MoviePilot instance. The tool list may vary by version and installed plugins.

### Method
GET

### Endpoint
/api/v1/mcp/tools

### Response
#### Success Response (200)
- **tools** (array) - List of available tool names.

#### Response Example
{
  "tools": ["search_torrents", "add_subscribe"]
}
```

--------------------------------

### 配置、工具与调度命令

Source: https://wiki.movie-pilot.org/cli

用于查看和修改配置、列出和运行工具、列出和运行调度任务。config path 显示配置路径；config list 列出配置；config get/set 获取/设置配置项；config keys 列出配置键；config describe 描述配置项；tool list 列出工具；tool show 显示工具详情；tool run 运行工具；scheduler list 列出调度任务；scheduler run 运行调度任务。

```shell
moviepilot config path
moviepilot config list
moviepilot config get PORT
moviepilot config set PORT 3001
moviepilot config keys
moviepilot config describe API_TOKEN

moviepilot tool list
moviepilot tool show query_schedulers
moviepilot tool run query_schedulers

moviepilot scheduler list
moviepilot scheduler run subscribe_refresh
```

--------------------------------

### GET /api/v1/mcp/tools

Source: https://wiki.movie-pilot.org/zh/mcp

列出全部 MCP 工具。

```APIDOC
## GET /api/v1/mcp/tools

### Description
列出 MoviePilot 当前暴露给 MCP 的全部工具。

### Method
GET

### Endpoint
/api/v1/mcp/tools

### Authentication
需要 API_TOKEN，通过 X-API-KEY 请求头或 ?apikey= 查询参数传递。

### Response
#### Success Response (200)
- 工具列表（具体结构未在文档中说明）

#### Response Example
（未提供）
```

--------------------------------

### Install pgloader and migrate SQLite data to PostgreSQL

Source: https://wiki.movie-pilot.org/configuration

Installs pgloader inside the PostgreSQL container and runs it to migrate data from the SQLite user.db file to the PostgreSQL database. This step is optional and only needed when migrating existing data; back up the SQLite database before migration.

```bash
# 进入容器
# docker exec -it postgresql bash
apt update
apt install pgloader

pgloader sqlite:////var/lib/postgresql/data/user.db postgresql://moviepilot:你的密码@localhost:5432/moviepilot
```

--------------------------------

### 安装与初始化命令

Source: https://wiki.movie-pilot.org/cli

用于安装依赖、前端、资源以及初始化或卸载 MoviePilot 本地环境。install deps 创建虚拟环境并安装后端依赖；install frontend 下载前端 release 并自动安装本地 Node 运行时；install resources 下载 MoviePilot-Resources 并同步到 app/helper；init 初始化本地配置；setup 串行执行依赖安装、前端安装、资源同步和初始化；uninstall 卸载本地运行环境，默认保留配置目录。

```shell
moviepilot install deps
moviepilot install frontend
moviepilot install resources
moviepilot init --wizard
moviepilot setup --wizard
moviepilot uninstall
```

--------------------------------

### 使用 docker-compose 更新 MoviePilot 镜像

Source: https://wiki.movie-pilot.org/upgrade

使用 docker-compose 拉取最新镜像并强制重建容器以应用更新。

```bash
docker-compose pull jxxghp/moviepilot-v2:latest
docker-compose up --force-recreate -d
```

--------------------------------

### 下载文件立即整理 curl 命令

Source: https://wiki.movie-pilot.org/configuration

用于 qbittorrent 下载完成后立即触发 MoviePilot 整理入库，避免等待默认的 5 分钟轮询间隔。地址、端口和 token 需按实际配置调整，curl 也可更换为 wget。

```bash
curl "http://localhost:3000/api/v1/transfer/now?token=moviepilot"
```

--------------------------------

### Create Redis data directory and start Redis container with persistence

Source: https://wiki.movie-pilot.org/configuration

Creates a persistent directory for Redis data and starts a Redis container with persistence enabled. The --requirepass option sets a password; it is recommended to use a complex password. If persistence is not enabled, cache data is lost on restart but the program continues to run normally.

```bash
# 创建持久化目录
mkdir -p /volume1/docker/redis/data

# 启动带持久化的Redis
docker run \
  --name my-redis \
  -p 6379:6379 \
  -v /volume1/docker/redis/data:/data \
  -d redis redis-server --save 600 1 --requirepass "你的密码"
```
Tokens:
Raw