MCP Radarr 和 Sonarr 服务器

一个与 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 参考

search_media

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

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

request_download

请求特定媒体的下载：

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

check_status

检查特定媒体的状态：

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

get_system_status

获取系统健康和存储信息：

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

响应包括：

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

资源

媒体作为资源暴露，具有以下 URI 方案：

• 电影：radarr://movie/{id}
• 电视剧：sonarr://series/{id}

每个资源包括：

• 标题
• 年份
• 当前状态