Private

MOVIEPILOT-MCP

Try Now

2025-04-14

MCP -Server für MoviePilot

3 years

Works with Finder

1

Github Watches

1

Github Forks

1

Github Stars

MoviePilot MCP 服务器

这是一个 模型上下文协议 (MCP - Model Context Protocol) 服务器实现，用于连接大型语言模型 (LLM) 与 MoviePilot 媒体库自动化管理服务器。

目标

本项目旨在让用户能够通过自然语言与他们的 MoviePilot 实例进行交互，从而实现以下功能：

搜索和发现 电影、电视剧及相关信息。
查询媒体详情、季集信息、演员阵容和推荐。
查找可用的下载资源 (种子)。
管理媒体订阅（添加、查看、更新、删除、启用/禁用）。
控制下载任务（添加、查看状态、暂停、恢复、删除）。
获取媒体库状态（最近添加、正在播放、检查存在性）。

通过将 MoviePilot 的功能暴露给 LLM，用户可以在支持 MCP 的聊天应用（如 Cherry Studio 或集成了 MCP 的客户端）中，用对话的方式轻松管理媒体库。

使用方式

在支持 MCP 的应用(如Cline)中添加以下配置。

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

如果使用的是Cherry Studio，参考上面的配置进行设置

核心功能

基于 MoviePilot 的 API，本 MCP 服务器计划（或已）暴露以下核心功能作为 MCP Tools：

1. 搜索与发现

搜索媒体: 根据标题/关键词查找电影、电视剧或人物。
- MCP Tool: search_media_or_person
- 示例: "搜索电影《星际穿越》", "找找演员 '基努·里维斯'"
探索: 探索来自豆瓣、TMDB的电影、电视剧。
- MCP Tool: discover_douban_media, discover_tmdb_media
- 示例: "推荐一些豆瓣高分科幻片", "看看TMDB上正在热映的电影"
获取TMDb新作: 获取TMDb即将上映的电影或最新播出的电视剧。
- MCP Tool: get_upcoming_or_newly_released_media
- 示例: "最近有什么新上映的电影吗？", "有哪些最近开播的电视剧？"

2. 获取详情

媒体详情: 查询电影或剧集的详细信息（简介、评分、ID 等）。
- MCP Tool: get_media_details
- 示例: "告诉我《沙丘2》的详细资料"
季集信息: 查询剧集的季列表或特定季的集信息。
- MCP Tool: get_season_episodes
- 示例: "《老友记》有几季？", "看看《怪奇物语》第4季每一集的标题"

3. 订阅管理

添加订阅: 新增电影或电视剧的自动下载/监控。
- MCP Tool: add_subscribe
- 示例: "订阅电影《沙丘2》", "订阅电视剧《黑暗荣耀》第一季，排除预告片"
查看订阅: 列出所有当前订阅或特定订阅的详情。
- MCP Tool: list_subscribes (列出所有), get_subscribe (获取单个)
- 示例: "我现在有哪些订阅？", "我订阅了《奥本海默》吗？ (使用 get_subscribe, id_type='tmdb', id_value='奥本海默的TMDB ID')", "查看订阅ID为5的详情 (使用 get_subscribe, id_type='subscribe', id_value='5')"
更新订阅: 修改现有订阅的设置（如过滤规则）。
- MCP Tool: update_subscribe
- 示例: "把我《最后生还者》的订阅改成只下载特效字幕组的版本 (需要提供完整的订阅信息，包括ID)"
删除订阅: 取消订阅。
- MCP Tool: delete_subscribe
- 示例: "取消我的《沙丘2》订阅 (使用 delete_subscribe, id_type='tmdb', id_value='沙丘2的TMDB ID')", " 删除订阅ID为5的订阅 (使用 delete_subscribe, id_type='subscribe', id_value='5')"
启用/禁用订阅: 暂停或恢复订阅的自动搜索。
- MCP Tool: set_subscribe_status
- 示例: "暂停订阅ID为3的订阅", "启用订阅ID为3的订阅"

4. 资源查找

精确搜索资源: 根据 TMDB ID 或豆瓣 ID 查找可下载的种子。
- API: GET /api/v1/search/media/{mediaid}
- 示例: "帮我找《奥本海默》的下载资源", "搜索《最后生还者》第一季所有集的下载"
模糊搜索资源: 根据关键词搜索种子。
- API: GET /api/v1/search/title
- 示例: "搜索标题里有 '4K HDR 蜘蛛侠' 的资源"

5. 下载任务管理

添加下载: 下载一个具体的种子。
- API: POST /api/v1/download/
- 示例: "下载刚才找到的那个《奥本海默》4K种子"
查看下载: 列出当前正在进行的下载任务。
- API: GET /api/v1/download/
- 示例: "看看现在有哪些任务在下载？进度怎么样？"
控制下载: 暂停、恢复或删除下载任务。
- API: GET /api/v1/download/stop/{hash}, GET /api/v1/download/start/{hash}, DELETE /api/v1/download/{hash}
- 示例: "暂停《沙丘2》的下载", "恢复下载《奥本海默》", "把那个下载失败的任务删掉"

6. 状态与历史查询

媒体库状态: 查看媒体服务器最近添加或正在播放的内容。
- API: GET /api/v1/mediaserver/latest, GET /api/v1/mediaserver/playing
- 示例: "我Jellyfin库里最近加了什么？", "现在有人在用Plex看电影吗？"
检查存在性: 查询某个媒体是否已在库中。
- API: GET /api/v1/mediaserver/exists
- 示例: "我库里有《星际穿越》了吗？", "《老友记》第一季全集都在吗？"
下载历史: (可选) 查看过去的下载记录。
- API: GET /api/v1/history/download
- 示例: "我上周下载了哪些电影？"

开发状态

当前状态: 逐步接入MoviePilot功能
未来计划: 提供MCP SSE部署方式

安全提示

环境安全: 本服务器需要存储MP账密，请确保你的环境安全。
账号安全: 建议建立一个专用的 MoviePilot 账号用于此 MCP 服务器，避免使用管理员账号。

开发指引

先决条件:

Python 3.12+
uv 包管理器
一个正在运行并可访问的 MoviePilot 服务器实例

步骤:

克隆仓库:

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

配置: 创建 .env 文件 (可以从 .env.example 复制) 并填入必要的配置信息：

# .env Example
MOVIEPILOT_BASE_URL=http://your-moviepilot-ip:3000  # 你的 MoviePilot 地址

# 配置认证方式
MOVIEPILOT_USERNAME=your_moviepilot_username  # 你的 MoviePilot 用户名 (用于密码认证)
MOVIEPILOT_PASSWORD=your_moviepilot_password  # 你的 MoviePilot 密码 (用于密码认证)

创建环境:
```
uv sync
```

贡献

欢迎贡献！如果你发现 Bug 或有功能建议，请提交 Issue。如果你想贡献代码，请 Fork 仓库并发起 Pull Request。

致谢

感谢 MoviePilot 项目。本项目是基于MoviePilot的API构建的，没有MoviePilot的出色工作，这个MCP服务器将无法实现。

许可证

本项目采用 MIT License 授权。

Reviews

3.3 (11)

user_NFseKUd0

2025-04-26

As a loyal user of MoviePilot-MCP, I am incredibly impressed by how this tool enhances my movie-watching experience. Created by Pollo3470, it intuitively tracks my preferences and suggests films I genuinely enjoy. The seamless navigation and user-friendly design make it a pleasure to use. Highly recommended for any film enthusiast!

user_7RULJvlC

2025-04-26

MoviePilot-MCP is an incredible tool for any movie enthusiast! Developed by Pollo3470, it's user-friendly and offers comprehensive features for tracking and reviewing movies. The intuitive design and functionality make it a joy to use. I've been able to keep all my movie preferences organized and discover new films effortlessly. Highly recommended for anyone passionate about cinema!

user_Ibb4PYSE

2025-04-26

I've been using MoviePilot-MCP by Pollo3470, and it's been a game-changer! It provides a seamless way to track and manage my movie viewing experience. The user interface is intuitive and the functionality is top-notch. Highly recommend for any movie enthusiast looking to streamline their movie-watching habits!

user_7sFoj9BC

2025-04-26

MoviePilot-MCP by Pollo3470 is a fantastic tool for movie enthusiasts like myself! It offers comprehensive details and insights on a wide range of films. The interface is user-friendly, and I love how it keeps me updated with the latest movie trends and reviews. Highly recommended for all movie buffs out there!

user_0BxCHchi

2025-04-26

I've been using MoviePilot-MCP by Pollo3470 for a while now, and it has completely transformed my movie-watching experience. The UI is intuitive and user-friendly, making it easy to navigate through its extensive database. It also provides fantastic recommendations based on my viewing history, which has led me to discover some amazing films I might have missed otherwise. Highly recommend it to any movie enthusiast!

user_8YojdHej

2025-04-26

As a dedicated user of MoviePilot-MCP, I've found it to be an exceptional application for movie enthusiasts. Pollo3470 has created a robust tool that always keeps me updated with the latest releases and reviews. The user interface is clean and intuitive, making it easy to navigate through different features. Highly recommended for anyone who loves movies!

user_TsZcJHsy

2025-04-26

MoviePilot-MCP is a game-changer for every movie enthusiast. Created by Pollo3470, this application offers an intuitive interface and an extensive database, making it incredibly easy to discover and keep track of movies. The user experience is seamless, and the welcome information is very inviting. I highly recommend MoviePilot-MCP to anyone looking to enhance their movie-watching experience!

user_Cst4zzih

2025-04-26

I've been using MoviePilot-MCP, developed by Pollo3470, and it's an incredible tool for movie enthusiasts. It offers a seamless way to track, rate, and discover movies. The user-friendly interface and extensive database make it a must-have for anyone passionate about films. Highly recommend!

user_ypE6irVT

2025-04-26

As an avid user of MoviePilot-MCP by Pollo3470, I must say it's an outstanding application for movie enthusiasts. The interface is user-friendly and the recommendations are spot-on, always introducing me to fantastic new films. It has truly enhanced my movie-watching experience, making it easier to discover and enjoy top-notch movies right from the start. Highly recommended!

user_aCHcmJXS

2025-04-26

As a devoted user of MoviePilot-MCP, I must say it's a game changer for movie enthusiasts! Pollo3470 has done a fantastic job creating a seamless and intuitive application. The interface is user-friendly, and I love how it integrates all the essential movie information seamlessly. Highly recommended for anyone who wants to enhance their movie-watching experience!

user_Re8SSFSx

2025-04-26

MoviePilot-MCP is an exceptional tool crafted by Pollo3470 for movie enthusiasts. As a dedicated user, I appreciate its seamless integration and user-friendly interface. It helps me keep track of my favorite films and discover new ones effortlessly. Highly recommend it to all movie buffs!

MOVIEPILOT-MCP

3 years

1

1

1

MoviePilot MCP 服务器

目标

使用方式

核心功能

1. 搜索与发现

2. 获取详情

3. 订阅管理

4. 资源查找

5. 下载任务管理

6. 状态与历史查询

开发状态

安全提示

开发指引

贡献

致谢

许可证

Prompt Starters

相关推荐

Reviews

user_NFseKUd0

user_7RULJvlC

user_Ibb4PYSE

user_7sFoj9BC

user_0BxCHchi

user_8YojdHej

user_TsZcJHsy

user_Cst4zzih

user_ypE6irVT

user_aCHcmJXS

user_Re8SSFSx