gptdarr

🚀 GPTDARR - 媒体中心管理工具（Sonarr & Radarr 集成版）

GPTDARR 是一款专为媒体库管理打造的工具，它基于模型上下文协议（MCP），与 Sonarr 和 Radarr 深度整合，能助力 AI 助手高效搜索、添加和管理电视剧集与电影，极大提升媒体库管理的便捷性。

🚀 快速开始

先决条件

• Node.js 18 或更高版本
• Sonarr 和 Radarr 已正确安装并运行
• 支持 MCP 协议的聊天客户端（例如 5ire、Claude）

安装与配置

1. 运行交互式配置向导：

   npx gptdarr setup
   

2. 向导将指导您完成以下设置：

   • Sonarr 的 URL 和 API 密钥
   • Radarr 的 URL 和 API 密钥
   • 两个服务的质量配置文件
   • 媒体存储的根目录
   • 日志记录偏好

3. 完成配置后，向导将生成一个推荐使用的 NPX 命令。复制此命令。

4. 在您的 MCP 兼容聊天客户端（例如 5ire）中：

   • 转到工具 > 新建 > 命令
   • 粘贴复制的命令
   • 您的聊天客户端现在可以启动并与 GPTDarr MCP 服务器通信

5. ⚠️ 重要提示

   在设置完成后，请使用提供的系统提示，位于 llm_system_prompt.txt。此提示包含 AI 助手与 Radarr 和 Sonarr 交互的关键指令，确保了电视剧和电影请求的一致处理、状态报告和内容管理的效率。

服务器提供的工具包括：

• lookup-content: 搜索电视剧集和电影

  • 参数：
    • title: 要搜索的内容标题
    • year（可选）：发布年份以细化搜索

• add-series: 将电视剧集添加到 Sonarr

  • 参数：
    • items: 要添加的 TV 系列列表，每个系列包含：
      • seriesName: 系列名称
      • seriesYear（可选）：系列年份

• add-movies: 将电影添加到 Radarr

  • 参数：
    • items: 要添加的电影列表，每部电影包括：
      • title: 电影标题
      • year（可选）：电影年份

日志记录

日志主要用于开发，建议在设置时禁用。

• 内容搜索记录
• 系列和电影添加记录
• 其他操作日志

日志文件位于默认路径下。

✨ 主要特性

• 可搜索 Sonarr 和 Radarr 中的电视剧集和电影。
• 能将电视剧集添加到 Sonarr。
• 可将电影添加到 Radarr。
• 具备全面的日志系统，用于调试和监控（目前这还是一个初期项目）。

📦 安装指南

先决条件

• Node.js 18 或更高版本。
• Sonarr 和 Radarr 已正确安装并运行。
• 支持 MCP 协议的聊天客户端（例如 5ire、Claude）。

安装步骤

1. 运行交互式配置向导：

   npx gptdarr setup
   

2. 向导将指导完成 Sonarr 和 Radarr 的 URL、API 密钥、质量配置文件、媒体存储根目录、日志记录偏好等设置。
3. 完成配置后，复制向导生成的推荐 NPX 命令。
4. 在 MCP 兼容聊天客户端（如 5ire）中，转到工具 > 新建 > 命令，粘贴复制的命令，即可启动并与 GPTDarr MCP 服务器通信。

📚 详细文档

当前限制

• 更适合处理电影；电视剧功能较为有限。
• 不支持单个季度和剧集文件检查。
• 监控状态切换尚未实现（未监控的项目将被忽略）。
• to hallucinating tool-usage，请确保工具正常运行。

待办事项

• [ ] 实现对单个季度和剧集文件的检查功能。
• [ ] 添加对监控状态切换的支持。
• [ ] 提升电视剧处理功能，使其与电影功能相匹配。
• [ ] 允许通过自然语言覆盖质量配置文件。
• [ ] 改进工具名称和描述，避免 LLM 误判工具调用（寻求专业建议）。
• [ ] 优化 LLM 系统提示，减少 hallucinations（寻求专业建议）。