MCP Radarr and Sonarr Server

MCP Radarr 和 Sonarr 服务

一个用于集成 Radarr 和 Sonarr、管理媒体库的 MCP 服务。

功能

当前功能：

• 浏览电影和电视节目库
• 按年份和类型搜索及筛选媒体
• 请求下载电影和电视节目
• 查看下载和监控状态
• 系统健康监控与管理
  • 磁盘空间监控
  • 系统健康检查
  • 状态报告

安装

本地安装

1. 安装依赖项：

pnpm install

全局安装

要在系统上全局安装 MCParr Server：

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",  // Required
  year?: number,                  // Optional
  genre?: string                  // Optional
}

request_download

请求下载指定媒体：

{
  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}

每项资源都包含：

• 标题
• 年份
• 当前状态