MCP Arr

🚀 MCP *arr Server

MCP *arr Server 是一款適用於 *arr 媒體管理套件（包括 Sonarr、Radarr、Lidarr、Readarr 和 Prowlarr）的服務器。它提供了統一的媒體管理接口，支持自然語言查詢、跨服務搜索等功能，能幫助用戶更高效地管理媒體資源。

🚀 快速開始

MCP *arr Server 為 *arr 媒體管理套件（如 Sonarr、Radarr、Lidarr、Readarr 和 Prowlarr）提供了 MCP 服務器支持。你可以通過以下步驟快速開始使用：

1. 確保滿足 先決條件。
2. 按照 安裝指南 進行安裝。
3. 完成 配置 步驟。
4. 參考 使用示例 進行操作。

✨ 主要特性

• 統一媒體管理：通過一個界面控制所有 *arr 應用程序。
• 自然語言查詢：使用自然英語詢問你的媒體庫信息。
• 跨服務搜索：同時在電視、電影、音樂和書籍中查找內容。
• 下載監控：檢查所有服務的隊列狀態和進度。
• 日曆集成：查看所有媒體類型的即將發佈內容。
• 配置審查：獲取由 AI 提供的優化設置建議。
• 靈活配置：僅啟用你使用的服務。

各服務功能詳情

📦 安裝指南

使用 npm（推薦）

npx mcp-arr-server

從源代碼安裝

git clone https://github.com/aplaceforallmystuff/mcp-arr.git
cd mcp-arr
npm install
npm run build

🔧 配置

獲取 API 密鑰

每個 *arr 應用程序在“設置 > 常規 > 安全”中都有一個 API 密鑰。獲取步驟如下：

1. 打開你的 *arr 應用程序的 Web 界面。
2. 轉到“設置”>“常規”。
3. 在安全部分找到“API 密鑰”。
4. 複製 API 密鑰以用於配置。

針對 Claude Desktop 的配置

將以下內容添加到你的 Claude Desktop 配置文件中： macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "arr": {
      "command": "npx",
      "args": ["-y", "mcp-arr-server"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-sonarr-api-key",
        "RADARR_URL": "http://localhost:7878",
        "RADARR_API_KEY": "your-radarr-api-key",
        "LIDARR_URL": "http://localhost:8686",
        "LIDARR_API_KEY": "your-lidarr-api-key",
        "READARR_URL": "http://localhost:8787",
        "READARR_API_KEY": "your-readarr-api-key",
        "PROWLARR_URL": "http://localhost:9696",
        "PROWLARR_API_KEY": "your-prowlarr-api-key"
      }
    }
  }
}

針對 Claude Code 的配置

將以下內容添加到 ~/.claude.json 文件中：

{
  "mcpServers": {
    "arr": {
      "command": "npx",
      "args": ["-y", "mcp-arr-server"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-sonarr-api-key",
        "RADARR_URL": "http://localhost:7878",
        "RADARR_API_KEY": "your-radarr-api-key"
      }
    }
  }
}

注意：僅配置你正在運行的服務。服務器會根據你提供的環境變量自動檢測可用的服務。

💻 使用示例

基礎用法

以下是一些常見的使用示例：

媒體庫管理

• "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"（搜索泰勒·斯威夫特的專輯）
• "Look up books by Brandon Sanderson"（查找布蘭登·桑德森的書籍）

下載隊列

• "What's downloading right now?"（現在正在下載什麼？）
• "Check the Sonarr queue"（檢查 Sonarr 隊列）
• "Show Radarr download progress"（顯示 Radarr 的下載進度）

即將發佈內容

• "What TV episodes are coming this week?"（本週有哪些電視劇集即將發佈？）
• "Show upcoming movie releases"（顯示即將上映的電影）
• "Any new albums coming out this month?"（本月有新專輯發佈嗎？）
• "Show me upcoming book releases"（顯示即將發佈的書籍）

內容下載

• "What episodes of Severance am I missing?"（我錯過了《人生切割術》的哪些劇集？）
• "Download the missing episodes for that show"（下載該電視劇缺失的劇集）
• "Search for this specific movie"（搜索這部特定的電影）
• "Grab that Japanese Breakfast album"（獲取那張 Japanese Breakfast 的專輯）
• "Download all missing books by Brandon Sanderson"（下載布蘭登·桑德森所有缺失的書籍）

索引器管理

• "Are my indexers healthy?"（我的索引器健康嗎？）
• "How are my indexers performing?"（我的索引器表現如何？）
• "Test all my Prowlarr indexers"（測試我所有的 Prowlarr 索引器）

配置審查（新增）

• "Review my Sonarr setup and suggest improvements"（審查我的 Sonarr 設置並提出改進建議）
• "Show me my quality profiles in Radarr"（顯示我在 Radarr 中的質量配置文件）
• "Are there any health issues with my Lidarr?"（我的 Lidarr 有健康問題嗎？）
• "What naming convention am I using for TV shows?"（我對電視劇使用的命名約定是什麼？）
• "Help me understand my quality profiles - why am I not getting 4K?"（幫助我理解我的質量配置文件 - 為什麼我沒有獲得 4K 內容？）
• "Check my download client configuration"（檢查我的下載客戶端配置）
• "How much free space do I have on my root folders?"（我的根文件夾有多少可用空間？）

跨服務操作

• "Check status of all my *arr services"（檢查我所有 *arr 服務的狀態）
• "Search for 'The Office' across all services"（在所有服務中搜索《辦公室》）

🔧 技術細節

可用工具

通用工具

Sonarr 工具（電視）

Radarr 工具（電影）

Lidarr 工具（音樂）

Readarr 工具（書籍）

Prowlarr 工具（索引器）

配置審查工具

這些工具適用於 Sonarr、Radarr、Lidarr 和 Readarr。將 {service} 替換為服務名稱（例如，sonarr_get_quality_profiles）。

{service}_review_setup 工具可以一次性返回所有配置信息，從而支持通過自然語言對話來優化你的設置。Claude 可以分析你的質量配置文件、提出改進建議、解釋為什麼某些內容無法獲取，並幫助配置複雜的設置，如自定義格式。

⚠️ 重要提示

配置審查工具僅提供對你 *arr 設置的 只讀 訪問權限。任何對配置的更改都必須直接在 *arr 應用程序界面中進行。AI 提供的建議僅為參考 - 在進行重大更改之前，請務必備份你的配置。維護者不對因遵循 AI 生成的建議而可能出現的任何配置更改、數據丟失或其他問題負責。

TRaSH 指南工具

你可以通過 Claude 直接訪問 TRaSH 指南 中社區整理的質量配置文件、自定義格式和命名約定。這些工具無需 *arr 配置 - 它們從 TRaSH 指南的 GitHub 存儲庫中獲取參考數據。

示例用法：

• "What quality profiles does TRaSH recommend for 4K movies?"（TRaSH 為 4K 電影推薦哪些質量配置文件？）
• "Show me the remux-web-1080p profile details"（顯示 remux-web-1080p 配置文件的詳細信息）
• "Compare my Radarr profile 4 against the TRaSH uhd-bluray-web profile"（將我的 Radarr 配置文件 4 與 TRaSH 的 uhd-bluray-web 配置文件進行比較）
• "What naming convention should I use for Plex?"（我應該為 Plex 使用什麼命名約定？）
• "List HDR-related custom formats for Radarr"（列出 Radarr 中與 HDR 相關的自定義格式）

數據會緩存 1 小時，以減少對 GitHub API 的調用。

開發

# 開發時的監視模式
npm run watch

# Build TypeScript
npm run build

# 本地運行
SONARR_URL="http://localhost:8989" SONARR_API_KEY="your-key" node dist/index.js

故障排除

"No *arr services configured"

確保你至少設置了一對 URL 和 API_KEY 環境變量：

SONARR_URL="http://localhost:8989"
SONARR_API_KEY="your-api-key"

"API error: 401 Unauthorized"

API 密鑰不正確。請在你的 *arr 應用程序的“設置 > 常規 > 安全”中驗證。

"fetch failed" or "ECONNREFUSED"

*arr 應用程序未運行或 URL 不正確。請驗證：

• 應用程序正在運行。
• URL 和端口正確。
• 沒有防火牆阻止連接。

"Sonarr/Radarr/etc not configured"

你嘗試使用未配置的服務的工具。請添加相應的 URL 和 API_KEY 環境變量。

🤝 貢獻

歡迎貢獻代碼！請參閱 CONTRIBUTING.md 瞭解貢獻指南。

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE。

🔗 鏈接

• Servarr Wiki - 所有 *arr 應用程序的文檔
• TRaSH Guides - 質量配置文件、自定義格式和設置指南
• Sonarr API Docs
• Model Context Protocol
• GitHub 倉庫