Mcparr Server

🚀 MCP 雷達和森蘭服務器

MCP 雷達和森蘭服務器是一個集成了雷達和森蘭的媒體中心平臺，可用於高效管理你的媒體庫，讓你輕鬆掌控各類影視資源。

🚀 快速開始

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",  // 必填
  year?: number,                  // 可選
  genre?: string                  // 可選
}

請求下載

請求特定媒體的下載：

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

檢查狀態

檢查特定媒體的狀態：

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

獲取系統狀態

獲取所選系統的運行狀況信息：

{
  system: "radarr" | "sonarr" | "both"  // 必填 - 指定要檢查的系統
}

響應包括：

• 系統狀態（版本、運行時間等）
• 磁盤空間信息
• 健康檢查結果

資源

媒體以資源形式暴露，帶有以下 URI 方案：

• 電影：radarr://movie/{id}
• 電視劇：sonarr://series/{id} 每個資源包括：
• 標題
• 年份
• 當前狀態