Moviepilot MCP

The MoviePilot MCP server is a protocol implementation that connects large language models with the MoviePilot media library management system, supporting media search, subscription management, download control and other functions through natural language interaction.

Entertainment and media Home automation and IoT #Media Management #Natural Language Interaction #Automation #Film and TV Resources .Python

rating : 2.5 points

downloads : 13

update time : 2025-04-29

What is the MoviePilot MCP Server?

This is an intelligent media management assistant that allows you to control the MoviePilot media library in a daily conversation manner. By connecting to large language models (such as ChatGPT), you can directly ask or command it to find movies, subscribe to new TV shows, manage download tasks, etc.

How to use MoviePilot MCP?

Simply add the server configuration in an application that supports the MCP protocol (such as Cherry Studio), and then make requests in natural language, for example, 'Find me the download resources for Oppenheimer' or 'Subscribe to Season 2 of The Last of Us'.

Applicable scenarios

Suitable for users who want to manage the media library through voice/chat, or for scenarios where they need to quickly operate the media library on mobile devices without memorizing complex operation processes.

Main Features

Intelligent Media SearchSupports multi - dimensional search for movies/TV shows by title, actor, rating, etc., and can obtain rich information from Douban and TMDb

Subscription ManagementAdd/modify/delete media subscriptions through conversation, and automatically monitor new resources and download them

Download ControlView download progress, pause/resume tasks, delete failed downloads, etc.

Media Library QueryCheck if media exists in the library, view recently added content, and get playback status

Advantages and Limitations

Advantages

Natural language interaction without the need to learn complex interfaces

Integrate rich media information from multiple data sources (Douban/TMDb)

Support full - process media management: from discovery to download and storage in the library

Fast response speed and high operation efficiency

Limitations

Requires a stable network connection

Some complex operations still need to be completed through the web - based interface

Depends on the accuracy of third - party media data sources

How to Use

Configure the MCP Client

Add the MoviePilot MCP server configuration in an application that supports MCP (such as Cherry Studio)

Start a Conversation

Enter your media management requests in the chat interface, for example: - 'Subscribe to Oppenheimer' - 'What new movies are recommended recently?'

View and Confirm

The system will return the found results or execution status, and you can choose to confirm the operation or modify the request

Usage Examples

Discover New MoviesWant to find recently popular high - rated movies and add them to the media library

Manage SubscriptionsCheck and update existing media subscriptions

Download ControlHandle tasks with slow download speeds

Frequently Asked Questions

What needs to be prepared in advance?

Which MCP clients are supported?

How to ensure account security?

What if the search is inaccurate?

Related Resources

MoviePilot Official Website

Main project repository and documentation

MCP Protocol Description

Official documentation of the Model Context Protocol

Configuration Video Tutorial

10 - minute quick configuration guide

🚀 MoviePilot-MCP

MoviePilot-MCP is an MCP (MCP might refer to Multi-Purpose Control Panel or other relevant technical terms) service tailored for movie enthusiasts, built upon the MoviePilot API. It offers a unified console to assist users in managing media libraries, searching for and downloading resources, and monitoring the status of download tasks.

🚀 Quick Start

MoviePilot-MCP is a service designed to streamline media management and resource downloading. It provides a centralized platform for users to handle various media - related operations.

✨ Features

Unified Console: Manage and monitor all media - related operations in one place.
Intelligent Search: Quickly find the desired movies or TV shows through precise and fuzzy search functions.
Scalability: Flexibly designed, with plans to offer SSE deployment in the future.
Security: Built - in security measures to ensure the safety of the environment and accounts.

💻 Usage Examples

Media Library Management

Add Media: Add new content to the media library via the API.
Delete Media: Remove unwanted content.
Search Media: Find specific movies or TV shows by title, year, or category.

Download Task Control

Start Download: Initiate a new download task.
Pause/Resume: Temporarily stop or restart a downloading task.
Delete Task: Cancel an unfinished download task.

Resource Management

Resource Search: Find downloadable torrents based on TMDB ID or Douban ID.
Fuzzy Search: Find resources by keywords.
History Record: View past download records.

📚 Documentation

Development Status

Currently, the project is in the stage of gradually integrating features. Future plans include providing SSE deployment to enhance the service's scalability and performance.

Security Tips

⚠️ Important Note

Environment Security: Ensure the environment where MoviePilot account information is stored is secure.

Account Security: It is recommended to create a dedicated account for this MCP server and avoid using the administrator account.

Development Guide

Prerequisites

Operating System: Python 3.12+ environment
Tool: uv package manager
Infrastructure: A running and accessible MoviePilot service instance

Configuration Steps

Clone the repository:

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

Create a configuration file:

Copy the .env.example file and rename it to .env.

Fill in the necessary configuration information, for example:

# .env example
MOVIEPILOT_BASE_URL=http://your-moviepilot-ip:3000  # Your MoviePilot address

# Configure the authentication method
MOVIEPILOT_USERNAME=your_moviepilot_username  # Your MoviePilot username (for password authentication)
MOVIEPILOT_PASSWORD=your_moviepilot_password  # Your MoviePilot password (for password authentication)

Create a development environment:
```
uv sync
```

🤝 Contribution

Community contributions are welcome! If you find a bug or have a feature suggestion, please submit it through the repository's Issues. Your contributions will help the project continuously improve.