使用说明

项目简介

MoviePilot MCP服务器是一个基于 模型上下文协议 (MCP) 构建的应用后端，旨在让用户可以通过自然语言与 MoviePilot 媒体库服务器进行交互。它将 MoviePilot 的强大媒体管理功能暴露给大型语言模型 (LLM)，使得用户可以在支持 MCP 的客户端中，通过对话轻松管理和操作自己的媒体库。

主要功能点

媒体内容发现与搜索: 通过关键词或名称搜索电影、电视剧和演员信息，发现热门和最新的媒体内容。
媒体详情查询: 获取电影、电视剧的详细信息，包括剧情简介、演员阵容、评分等。
媒体资源查找: 搜索可用于下载的媒体资源（种子）。
自动化订阅管理: 订阅喜欢的电影或电视剧，实现自动下载和媒体库更新。支持查看、更新、删除和启/禁用订阅。
下载任务管理: 控制媒体下载任务，包括添加下载、查看下载状态、暂停、恢复和删除任务。
媒体库状态查询: 查看媒体库的最新动态，例如最近添加的媒体或正在播放的内容。

安装步骤

克隆仓库:

git clone https://github.com/Pollo3470/MoviePilot-MCP
cd MoviePilot-MCP

配置环境变量: 复制 '.env.example' 文件并重命名为 '.env'，根据你的 MoviePilot 服务器信息填写以下配置：

MOVIEPILOT_BASE_URL=http://your-moviepilot-ip:3000  # 你的 MoviePilot 服务器地址
MOVIEPILOT_USERNAME=your_moviepilot_username  # 你的 MoviePilot 用户名
MOVIEPILOT_PASSWORD=your_moviepilot_password  # 你的 MoviePilot 密码

创建并激活虚拟环境:
```
uv sync
```

服务器配置

在支持 MCP 协议的客户端（例如 Cline 或 Cherry Studio）中，你需要配置 MCP 服务器连接信息。以下是 MoviePilot MCP 服务器的典型配置，请根据你的实际情况进行调整：

{
  "mcpServers": {
    "moviepilot": {
      "command": "uvx",
      "args": [
        "moviepilot-mcp"
      ],
      "env": {
        "MOVIEPILOT_BASE_URL": "你的 MoviePilot 服务器URL",
        "MOVIEPILOT_USERNAME": "你的 MoviePilot 用户名",
        "MOVIEPILOT_PASSWORD": "你的 MoviePilot 密码"
      }
    }
  }
}

配置参数说明:

'server name': 'moviepilot' (服务器名称，可以自定义)
'command': 'uvx' (启动命令，使用 uv 包管理器运行)
'args': '["moviepilot-mcp"]' (启动参数，指向 'moviepilot_mcp' 入口)
'env': 环境变量配置，包含连接 MoviePilot 服务器所需的凭据：
- 'MOVIEPILOT_BASE_URL': MoviePilot 服务器的 URL 地址 (例如 'http://your-moviepilot-ip:3000')
- 'MOVIEPILOT_USERNAME': 访问 MoviePilot 服务器的用户名
- 'MOVIEPILOT_PASSWORD': 访问 MoviePilot 服务器的密码

注意: 请将 'env' 中的 'MOVIEPILOT_BASE_URL', 'MOVIEPILOT_USERNAME', 'MOVIEPILOT_PASSWORD' 替换为你实际的 MoviePilot 服务器配置信息。

基本使用方法

确保 MoviePilot MCP 服务器已成功启动并运行。
在支持 MCP 协议的客户端中，按照上述 服务器配置 正确配置 MoviePilot MCP 服务器。
在客户端中，使用自然语言指令与 MoviePilot 媒体库进行交互。例如：
- "搜索电影《星际穿越》"
- "订阅电视剧《权力的游戏》"
- "看看最近有什么热门电影"
- "暂停《沙丘》的下载任务"

客户端会将你的自然语言指令转换为 MCP 请求发送给 MoviePilot MCP 服务器，服务器会调用相应的 MoviePilot API 完成操作，并将结果返回给客户端。你就可以通过对话的方式轻松管理你的媒体库了。

关键词