Media Automation Hub (YARR)

🚀 🎬 YARR 媒體棧 MCP 服務器

YARR 媒體棧 MCP 服務器是一個全面的模型上下文協議（MCP）服務器，它能將大型語言模型（LLMs）與您自託管的媒體技術堆棧相連接。藉助該項目，您不僅可以通過自然語言對媒體服務進行智能自動化控制，還能保留傳統的程序式訪問方式，為媒體服務管理帶來極大便利。

🚀 快速開始

YARR 媒體棧 MCP 服務器可幫助您利用大型語言模型實現對媒體服務的自然語言控制，同時支持傳統的程序式訪問。以下是使用該服務器的基本步驟。

✨ 主要特性

• 🤖 支持基於 LLM 的自然語言控制媒體服務，讓交互更加智能便捷。
• 🔌 採用模塊化架構，方便進行功能擴展，以適應不同的業務需求。
• 通過 MCP 協議實現跨服務通信，確保各媒體服務之間的數據交互順暢。
• 支持多平臺和設備的命令執行，具備廣泛的適用性。
• 提供詳細的日誌記錄和監控功能，便於對系統運行狀態進行跟蹤和管理。

📦 安裝指南

安裝依賴

npm install @gotify/core @prowlarr/core @sonarr/core @overseerr/core mcp-server

創建 MCP 服務器配置文件 config.json

{
  "services": {
    "sonarr": {
      "url": "http://localhost:8989",
      "apiKey": "your_sonarr_api_key"
    },
    "prowlarr": {
      "url": "http://localhost:9696",
      "apiKey": "your_prowlarr_api_key"
    },
    "overseerr": {
      "url": "http://localhost:5055",
      "apiKey": "your_overseerr_api_key"
    },
    "gotify": {
      "url": "http://localhost:8080",
      "appToken": "your_gotify_app_token",
      "clientToken": "your_gotify_client_token"  # 可選，用於接收消息
    }
  },
  "logging": {
    "level": "info",
    "outputPath": "./logs"
  },
  "monitoring": {
    "enabled": true,
    "interval": 60000
  }
}

💻 使用示例

基礎用法

以下是對不同媒體服務進行操作的基本命令示例：

Sonarr 操作

// 系列管理
sonarr:search              - 在所有索引器中搜索電視劇
sonarr:list-series         - 列出所有監控的電視劇  
sonarr:series-details      - 獲取特定電視劇的詳細信息
sonarr:add-series         - 添加新的電視劇到監控列表
sonarr:monitor-season     - 監控或取消監控某一季
sonarr:list-profiles      - 列出質量與語言配置文件
sonarr:upcoming          - 獲取即將上映的劇集
sonarr:queue             - 查看當前下載隊列
sonarr:remove-from-queue - 從隊列中移除某個項目

Prowlarr 操作

prowlarr:search           - 在所有索引器中搜索
prowlarr:list-indexers    - 列出配置的索引器
prowlarr:indexer-stats    - 獲取索引器性能統計信息
prowlarr:check-config     - 驗證 Prowlarr 連接狀態

Overseerr 操作

overseerr:search          - 搜索電影和電視劇
overseerr:request         - 請求一部電影或電視劇
overseerr:list-requests   - 列出所有媒體請求
overseerr:update-request  - 更新某個請求的狀態
overseerr:trending        - 獲取熱門媒體及其推薦
overseerr:available       - 獲取流行且可獲得的媒體
overseerr:status          - 獲取系統狀態

Gotify 操作

gotify:messages:list      - 分頁列出消息
gotify:messages:send      - 發送新消息
gotify:messages:delete    - 根據 ID 刪除消息
gotify:messages:cleanup   - 刪除舊消息
gotify:apps:list         - 列出所有應用
gotify:apps:create       - 創建新的應用
gotify:clients:list      - 列出所有客戶端
gotify:clients:create    - 創建新的客戶端
gotify:health           - 檢查 Gotify 服務器健康狀態
gotify:stats            - 獲取 Gotify 統計信息

通過以上命令，您可以方便地控制和管理您的媒體服務，實現自動化的工作流程。