GPTDARR-声纳雷达MCP服务器
描述
GPTDARR是一个使用模型上下文协议（MCP）的AI工具服务器，与Sonarr和Radarr集成。它可以帮助AI助手搜索、添加和管理媒体库中的电视节目和电影。
特性
- 搜索Sonarr和Radarr的电视节目和电影
- 将电视剧添加到Sonarr
- 将电影添加到Radarr
- 用于调试和监控的综合日志系统（很抱歉，这是一个正在进行中的应用程序）
当前限制
- 与电影配合得最好；电视节目支持较为有限
- 不支持单个季节和剧集文件检查
- 未实现监控切换（忽略未监控的项目）
- 容易产生幻觉的工具使用，确保它运行工具。
全部
- \[\]执行个别季节和剧集文件检查
- \[\]添加对切换监控状态的支持
- \[\]改进电视节目支持，以匹配电影功能
- \[\]通过自然语言覆盖质量配置文件
- \[\]改进工具命名和描述，这样LLM就不会产生工具调用的幻觉（在这里寻求专家建议）
- \[\]改善LLM系统提示以减少幻觉（在这里也寻求专家建议）
入门指南
先决条件
- Node.js 18或更高版本
- Sonarr和Radarr安装并运行
- MCP兼容的聊天客户端（如5ire、Claude）
安装和设置
- 运行交互式配置向导：
npx gptdarr setup- 向导将指导您完成设置：
- Sonarr URL和API密钥 - Radarr URL和API密钥 - 两种服务的质量概况 - 用于媒体存储的根文件夹 - 日志记录首选项
- 完成设置后，向导将生成NPX命令（推荐）。复制此命令。
- 在您的MCP兼容聊天客户端（例如5ire）中：
- 转到“工具”>“新建”>“命令” - 粘贴复制的命令 - 聊天客户端现在将能够启动GPTDarr MCP服务器并与之通信
- 重要提示：系统提示
- 设置工具后，请确保使用位于中的提供的系统提示 llm_system_prompt.txt - 此提示包含AI助手与Radarr和Sonarr正确交互的基本说明 - 该提示可确保对电影和电视节目请求的一致处理、适当的状态报告和高效的内容管理
服务器提供以下工具：
- 查找内容：搜索电视节目和电影
- 参数： - title：要搜索的标题 - year （可选）：发布年份以优化搜索
- 添加系列：将电视剧添加到Sonarr
- 参数： - items：要添加的电视剧列表，每部都有： - seriesName：电视剧名称 - seriesYear （可选）：电视剧的年份
- 添加电影：将电影添加到Radarr
- 参数： - items：要添加的电影列表，每部电影都有： - title：电影标题 - year （可选）：电影年份
日志记录
这些日志主要用于开发，我们建议在运行安装程序时禁用它们。
- 内容查找
- 系列和电影补充
- API请求和响应
- 错误和异常
日志存储在您的主目录中 .gptdarr 文件夹。
贡献
欢迎投稿！请阅读我们的 贡献指南 了解更多信息。
许可证
该项目根据 MIT许可证.
