MoviePilot MCP Admin

MoviePilot MCP Admin

Enables AI agents to control MoviePilot through the MCP protocol for managing subscriptions, downloads, media searches, and system status.

Category
Visit Server

README

MoviePilot MCP Admin

MoviePilot MCP 服务管理插件 - 让 AI Agent 通过 MCP 协议控制 MoviePilot

功能特性

  • 🔌 MCP 协议支持: 实现标准 Model Context Protocol，让 AI Agent 可以调用 MoviePilot 功能
  • 📺 订阅管理: 通过自然语言添加、删除、查看订阅
  • ⬇️ 下载控制: 暂停、恢复、删除下载任务
  • 🔍 媒体搜索: 搜索电影、电视剧信息
  • 📊 系统状态: 查看系统运行状态和日志

支持的 MCP 工具

订阅管理

工具 描述
subscribe_list 列出所有订阅
subscribe_add 添加订阅
subscribe_delete 删除订阅

下载管理

工具 描述
download_list 列出下载任务
download_pause 暂停下载
download_resume 恢复下载
download_delete 删除下载

媒体搜索

工具 描述
media_search 搜索媒体信息
media_details 获取媒体详情
media_exists 检查媒体是否存在

系统管理

工具 描述
system_status 获取系统状态
system_restart 重启服务
system_logs 获取日志

安装

方法 1: 插件市场

在 MoviePilot 插件市场中添加仓库地址：

https://github.com/q2a3z4w/moviepilot-mcp-admin

方法 2: 手动安装

  1. 克隆仓库到 app/plugins/moviepilot_mcp_admin 目录
  2. 重启 MoviePilot

配置

  1. 在 MoviePilot 设置中找到「MCP服务管理」
  2. 启用 MCP 服务
  3. 复制生成的 API Key（用于 AI Agent 认证）

AI Agent 配置

Claude Desktop

{
  "mcpServers": {
    "moviepilot": {
      "url": "http://localhost:3001/api/v1/mcp",
      "headers": {
        "X-API-KEY": "your_api_key_here"
      }
    }
  }
}

OpenClaw

使用 mcporter 工具添加 MoviePilot MCP 服务。

API 端点

方法 路径 描述
POST /api/v1/mcp MCP JSON-RPC 端点
GET /api/v1/mcp/tools 列出所有工具
GET /api/v1/mcp/tools/{name} 获取工具详情

使用示例

自然语言订阅

用户: "帮我订阅电视剧《黑暗荣耀》第二季"
AI: 调用 subscribe_add(title="黑暗荣耀", year="2024", media_type="电视剧", season=2)

查询下载状态

用户: "现在有哪些任务在下载？"
AI: 调用 download_list(status="active")

开发

# 克隆项目
git clone https://github.com/q2a3z4w/moviepilot-mcp-admin

# 安装依赖（如需要）
pip install -r requirements.txt

# 复制到 MoviePilot 插件目录
cp -r app/plugins/moviepilot_mcp_admin <moviepilot>/app/plugins/

技术栈

  • Python 3.12+
  • FastAPI
  • MoviePilot Plugin Framework V2
  • JSON-RPC 2.0

License

MIT

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured