GPTDARR - Sonarr & Radarr MCP Server

GPTDARR - Sonarr 和 Radarr MCP 服务

描述

GPTDARR 是一款使用 Model Context Protocol（MCP）的 AI 工具服务，可与 Sonarr 和 Radarr 集成。它可帮助 AI 助手在媒体库中搜索、添加和管理电视剧与电影。

功能

• 在 Sonarr 和 Radarr 中搜索电视剧与电影
• 向 Sonarr 添加电视剧
• 向 Radarr 添加电影
• 完善的日志系统，便于调试和监控（抱歉日志有点多，这个应用目前还处于开发初期）

当前限制

• 最适用于电影；对电视剧的支持较有限
• 不支持单独检查季和剧集文件
• 尚未实现监控开关（忽略未监控的项目）
• 容易产生工具使用幻觉，请确保它实际运行了工具。

待办事项

• 实现单独检查季和剧集文件
• 添加切换监控状态的支持
• 改进电视剧支持，使其达到电影功能的水平
• 通过自然语言覆盖质量配置文件
• 改进工具名称和描述，避免大模型产生工具调用幻觉（欢迎专家提供建议）
• 改进大模型系统提示词，以减少幻觉（也欢迎专家提供建议）

入门指南

先决条件

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

安装与设置

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

   npx gptdarr setup
   

2. 向导将引导你完成以下设置：

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

3. 完成设置后，向导将生成一条 NPX 命令（推荐）。复制该命令。

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

   • 前往 Tools > New > Command
   • 粘贴复制的命令
   • 聊天客户端现在即可启动 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 许可证授权。