GPTDARR - Sonarr & Radarr MCP Server

基本能力

产品定位

GPTDARR 是一个AI驱动的媒体管理工具，旨在通过AI助手自动化电视节目和电影的搜索、添加和管理流程。

核心功能

• 搜索功能：在Sonarr和Radarr中搜索电视节目和电影。
• 添加功能：将电视节目添加到Sonarr，将电影添加到Radarr。
• 日志系统：提供详细的日志记录，便于调试和监控。

适用场景

• 自动化媒体库管理，减少手动操作。
• 通过AI助手快速搜索和添加新的电视节目和电影。
• 调试和监控媒体库的添加和管理流程。

工具列表

• lookup-content：搜索电视节目和电影。
• 参数：title（标题），year（可选，发布年份）。
• add-series：添加电视节目到Sonarr。
• 参数：items（电视节目列表，包含seriesName和可选的seriesYear）。
• add-movies：添加电影到Radarr。
• 参数：items（电影列表，包含title和可选的year）。

常见问题解答

• 当前限制：
• 对电影的支持较好，电视节目支持有限。
• 不支持单个季节和剧集文件检查。
• 监控切换功能未实现。
• 容易出现工具使用幻觉，需确保工具运行。

使用教程

使用依赖

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

安装教程

1. 运行交互式配置向导： bash npx gptdarr setup
2. 向导将引导您设置：
3. Sonarr URL和API密钥。
4. Radarr URL和API密钥。
5. 质量配置文件。
6. 媒体存储的根文件夹。
7. 日志记录偏好。
8. 完成设置后，向导将生成一个NPX命令，复制此命令。
9. 在兼容MCP的聊天客户端中：
10. 转到工具 > 新建 > 命令。
11. 粘贴复制的命令。
12. 聊天客户端现在可以启动并与GPTDarr MCP服务器通信。
13. 重要：系统提示：
14. 使用提供的系统提示（位于llm_system_prompt.txt）。
15. 提示包含AI助手与Radarr和Sonarr交互的基本指令。

调试方式

• 日志存储在用户主目录的.gptdarr文件夹中。
• 日志内容包括内容查找、系列和电影添加、API请求和响应、错误和异常。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。