mcparr-server

🚀 MCP 雷达和森兰服务器

MCP 雷达和森兰服务器是一个集成了雷达和森兰的媒体中心平台，可用于高效管理你的媒体库，让你轻松掌控各类影视资源。

🚀 快速开始

MCP 雷达和森兰服务器能帮助你浏览、搜索、下载和监控媒体资源，同时还具备系统健康监测与管理功能。以下为你介绍具体的使用步骤。

✨ 主要特性

当前功能：

• 可轻松浏览你的电影和电视剧库，快速找到心仪影片。
• 支持搜索并过滤媒体，能按年份和类型进行筛选，精准定位资源。
• 可请求电影和电视剧的下载，满足观看需求。
• 能检查下载和监控状态，随时了解进度。
• 具备系统健康监测与管理功能：
  • 可监控磁盘空间，避免空间不足影响使用。
  • 能进行系统运行状况检查，保障系统稳定。
  • 提供状态报告，让你对系统情况一目了然。

📦 安装指南

本地安装

1. 安装依赖：

pnpm install

全局安装

若要在系统中全局安装 MCParr 服务器，可执行以下命令：

pnpm run install-global

此操作将使 mcparr 命令在你的终端中全局可用。

📚 详细文档

配置

1. 设置环境变量：

export RADARR_URL=http://your-radarr-instance:7878
export RADARR_API_KEY=your-radarr-api-key
export SONARR_URL=http://your-sonarr-instance:8989
export SONARR_API_KEY=your-sonarr-api-key

或者在项目目录中创建一个 .env 文件，将这些变量包含其中。

使用

本地运行

构建并启动服务器：

pnpm run build
pnpm start

开发模式下运行：

pnpm run dev

全局运行

如果已全局安装，可以直接运行：

mcparr

API 参考

搜索媒体

搜索电影或电视剧，并可使用过滤器：

{
  mediaType: "movie" | "series",  // 必填
  year?: number,                  // 可选
  genre?: string                  // 可选
}

请求下载

请求特定媒体的下载：

{
  mediaType: "movie" | "series",  // 必填
  id: number                      // 必填
}

检查状态

检查特定媒体的状态：

{
  mediaType: "movie" | "series",  // 必填
  id: number                      // 必填
}

获取系统状态

获取所选系统的运行状况信息：

{
  system: "radarr" | "sonarr" | "both"  // 必填 - 指定要检查的系统
}

响应包括：

• 系统状态（版本、运行时间等）
• 磁盘空间信息
• 健康检查结果

资源

媒体以资源形式暴露，带有以下 URI 方案：

• 电影：radarr://movie/{id}
• 电视剧：sonarr://series/{id} 每个资源包括：
• 标题
• 年份
• 当前状态