MoviePilot-MCP

MoviePilot-MCP

2
entertainment_and_media

MoviePilot MCP Server is a Model Context Protocol server implementation designed to enable natural language interaction with the MoviePilot media library management system. It allows users to search, query, manage, and control various media-related tasks directly through supported chat applications or interfaces.

MoviePilot MCP Server Project

A server implementation of the Model Context Protocol (MCP) to connect large language models with the MoviePilot media library automation management server.

Objective

  • Interact with MoviePilot using natural language.
  • Search and discover movies, TV shows, and related information.
  • Query media details and season episodes.
  • Manage media subscriptions and control download tasks.
  • Check media library status.

Usage

  • Docker: Deploy using Docker or docker-compose.
    • Pull the Docker image: pollo3470/moviepilot-mcp.
    • Configure necessary environment variables in a .env file.
    • Run the Docker container or use docker-compose.
  • Stdio mode: Configure MCP-supported applications.

Core Features

  • Search & Discover: Find media by title/keyword.
  • Get Details: Retrieve detailed media info.
  • Subscription Management: Add, update, delete subscriptions.
  • Resource Lookup: Search for downloadable resources.
  • Download Management: Control and view download tasks.
  • Status & History Query: Check current library status.

Development Status

  • Gradually integrating MoviePilot features; planning MCP SSE deployment.

Security Tips

  • Ensure account and environment security when storing credentials.

Development Guide

  • Prerequisites: Python 3.12+
  • Clone repository, configure .env, and sync environment.

Contribution

  • Bugs or suggestions? Submit issues. For code contributions, fork the repo and submit a pull request.

Acknowledgments

  • Thanks to MoviePilot for providing the API on which this server is built.

License

  • Licensed under MIT.