媒体库管理服务器

一个集成Radarr和Sonarr的MCP服务器,用于管理电影和电视剧库,支持浏览、搜索、下载请求和系统健康监控。

  • by JasonTulp
  • JavaScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 JasonTulp/mcparr-server

使用说明

MCP雷达和声纳服务器

与Radarr和Sonarr集成的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",  // Required
  year?: number,                  // Optional
  genre?: string                  // Optional
}

请求下载

请求下载特定媒体:

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

check_status

检查特定媒体的状态:

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

get_system_status

获取系统运行状况和存储信息:

{
  system: "radarr" | "sonarr" | "both"  // Required - Which system to check
}

答复包括:

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

资源

媒体作为具有以下URI方案的资源公开:

  • 电影: radarr://movie/{id}
  • 电视节目: sonarr://series/{id}

每种资源包括:

  • 标题
  • 年
  • 当前状态