GPTDARR - Sonarr & Radarr MCP 服务器

描述

GPTDARR 是一个使用模型上下文协议 (MCP) 并与 Sonarr 和 Radarr 集成的 AI 工具服务器。它可以帮助 AI 助手搜索、添加和管理媒体库中的电视节目和电影。

功能

• 在 Sonarr 和 Radarr 中搜索电视节目和电影
• 将电视剧添加到 Sonarr
• 将电影添加到 Radarr
• 综合日志记录系统，用于调试和监控（抱歉有点乱，这仍然是一个正在开发中的应用程序）

当前限制

• 最适合电影；对电视节目的支持较为有限
• 不支持单个季和剧集文件检查
• 监控切换未实现（未监控的项目将被忽略）
• 容易产生工具使用幻觉，请确保它运行了工具。

待办事项

• [ ] 实现单个季和剧集文件检查
• [ ] 添加对切换监控状态的支持
• [ ] 改进电视节目支持以匹配电影功能
• [ ] 通过自然语言覆盖质量配置文件
• [ ] 改进工具命名和描述，以便 LLM 不会产生工具调用幻觉（正在寻找专家建议）
• [ ] 改进 LLM 系统提示以减少幻觉（也在寻找专家建议）

入门

前提条件

• 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: 要添加的电视剧列表，每个列表包含：
      • seriesName: 电视剧名称
      • seriesYear (可选): 电视剧年份

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

  • 参数：
    • items: 要添加的电影列表，每个列表包含：
      • title: 电影标题
      • year (可选): 电影年份

日志记录

日志主要用于开发，我们建议在运行设置时禁用它们。

• 内容查找
• 电视剧和电影添加
• API 请求和响应
• 错误和异常

日志存储在您主目录的 .gptdarr 文件夹中。

贡献

欢迎贡献！请阅读我们的 贡献指南 了解更多信息。

许可证

本项目根据 MIT 许可证 获得许可。