媒体库管理服务器

GPTDARR-声纳雷达MCP服务器

描述

GPTDARR是一个使用模型上下文协议（MCP）的AI工具服务器，与Sonarr和Radarr集成。它可以帮助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正确交互的基本说明
   • 该提示可确保对电影和电视节目请求的一致处理、适当的状态报告和高效的内容管理

服务器提供以下工具：

• 查找内容：搜索电视节目和电影

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

• 添加系列：将电视剧添加到Sonarr

  • 参数：
    • items：要添加的电视剧列表，每部都有：
      • seriesName：电视剧名称
      • seriesYear （可选）：电视剧的年份

• 添加电影：将电影添加到Radarr

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

日志记录

这些日志主要用于开发，我们建议在运行安装程序时禁用它们。

• 内容查找
• 系列和电影补充
• API请求和响应
• 错误和异常

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

贡献

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

许可证

该项目根据 MIT许可证.