关键词

媒体管理SonarrRadarrLidarrReadarrProwlarr家庭影院

项目简介

MCP *arr 媒体管理服务器是一个功能强大的工具，它通过 Model Context Protocol (MCP) 标准，允许你使用自然语言（例如通过支持MCP协议的LLM客户端）来管理你的整个 *arr 媒体管理套件。它支持 Sonarr（电视剧）、Radarr（电影）、Lidarr（音乐）、Readarr（书籍）和 Prowlarr（索引器），为你提供一个统一、智能化的接口来查询媒体信息、监控下载进度、查看即将发布的内容，甚至触发下载任务。

主要功能点

  • 统一媒体管理: 从单一界面集中控制所有已配置的 *arr 应用，无需分别登录。
  • 自然语言查询: 以日常口语化的方式提问，获取关于你媒体库的详细信息。
  • 跨服务搜索: 能够同时在电视节目、电影、音乐和书籍之间进行内容搜索。
  • 下载监控: 实时查看所有 *arr 服务中的下载队列状态和进度。
  • 日历集成: 一览所有媒体类型（电视、电影、音乐、书籍）的即将发布日期。
  • 灵活配置: 只需配置你正在使用的 *arr 服务，服务器会自动识别并启用。
  • 丰富的工具集: 提供详细的工具，用于列出媒体内容、搜索新项目、管理下载队列、触发缺失内容下载以及管理索引器等。

安装步骤

  1. 准备 Node.js 环境: 确保你的系统已安装 Node.js 18 或更高版本。
  2. *运行 arr 应用: 确保你的至少一个 *arr 应用（如 Sonarr, Radarr, Lidarr, Readarr, Prowlarr）正在运行，并且你已获取其 API 密钥（通常在 *arr 应用的“设置”>“通用”>“安全”部分查找）。
  3. *安装并启动 MCP arr 服务器: 打开终端或命令行界面，运行以下命令即可安装并启动 MCP *arr 服务器： 
    npx mcp-arr-server
    这个命令会自动处理安装依赖并启动服务器。

服务器配置

要将此 MCP 服务器连接到你的 MCP 客户端（例如支持 MCP 协议的 Claude Desktop 或 Claude Code），你需要将以下 JSON 格式的配置添加到你的客户端配置文件中。服务器会根据你通过环境变量提供的 URL 和 API 密钥自动检测并启用相应的 *arr 服务。

{
  "mcpServers": {
    "arr": {
      "command": "npx",
      "args": ["-y", "mcp-arr-server"],
      "env": {
        "SONARR_URL": "http://localhost:8989",      // 你的 Sonarr 服务的访问 URL (例如：http://你的IP:8989)
        "SONARR_API_KEY": "你的SonarrAPI密钥",     // 从 Sonarr 应用设置中获取的 API 密钥
        "RADARR_URL": "http://localhost:7878",      // 你的 Radarr 服务的访问 URL
        "RADARR_API_KEY": "你的RadarrAPI密钥",     // 从 Radarr 应用设置中获取的 API 密钥
        "LIDARR_URL": "http://localhost:8686",      // 你的 Lidarr 服务的访问 URL
        "LIDARR_API_KEY": "你的LidarrAPI密钥",     // 从 Lidarr 应用设置中获取的 API 密钥
        "READARR_URL": "http://localhost:8787",     // 你的 Readarr 服务的访问 URL
        "READARR_API_KEY": "你的ReadarrAPI密钥",    // 从 Readarr 应用设置中获取的 API 密钥
        "PROWLARR_URL": "http://localhost:9696",    // 你的 Prowlarr 服务的访问 URL
        "PROWLARR_API_KEY": "你的ProwlarrAPI密钥"   // 从 Prowlarr 应用设置中获取的 API 密钥
      }
    }
  }
}

请注意： 你只需要配置你实际运行并希望通过此 MCP 服务器管理的 *arr 服务的 'URL' 和 'API_KEY'。

基本使用方法

配置完成后，你的 MCP 客户端（例如 LLM 应用）将能够通过自然语言与 MCP *arr 服务器进行通信，执行以下操作：

  • 媒体库查询:
    • "Show me all my TV series." (显示我所有的电视剧。)
    • "What movies do I have in Radarr?" (Radarr 里有哪些电影？)
    • "List all artists in my music library." (列出我音乐库中所有的艺术家。)
    • "How many books do I have by Stephen King?" (史蒂芬·金有多少本书？)
  • 内容搜索:
    • "Search for Breaking Bad on Sonarr." (在 Sonarr 上搜索《绝命毒师》。)
    • "Find the movie Inception." (查找电影《盗梦空间》。)
    • "Search for Taylor Swift albums." (搜索泰勒·斯威夫特的专辑。)
  • 下载与队列管理:
    • "What's downloading right now?" (现在正在下载什么？)
    • "Check the Sonarr queue." (检查 Sonarr 的下载队列。)
    • "Download the missing episodes for that show." (下载那个节目的缺失剧集。)
    • "Grab that Japanese Breakfast album." (获取那个 Japanese Breakfast 的专辑。)
  • 即将发布内容:
    • "What TV episodes are coming this week?" (本周有哪些新剧集？)
    • "Show upcoming movie releases." (显示即将上映的电影。)
  • 索引器管理 (Prowlarr):
    • "Are my indexers healthy?" (我的索引器是否健康？)
    • "How are my indexers performing?" (我的索引器表现如何？)
  • 跨服务操作:
    • "Check status of all my *arr services." (检查所有 *arr 服务的状态。)
    • "Search for 'The Office' across all services." (在所有服务中搜索《办公室》。)

信息

分类

桌面与硬件

访问项目