GPTDARR - Sonarr & Radarr MCP Server

🛠️ GPTDARR - Sonarr & Radarr MCP Server 是什么？

GPTDARR 是一个基于 Model Context Protocol（MCP）的工具，用来简化对 Sonarr 和 Radarr 的操作。它不替换你现有的媒体管理服务，而是作为一层智能接口，让你能用自然语言完成影视内容的搜索、添加和管理。它的目标很直接：减少在多个界面间切换、手动填写表单或记忆 API 流程的麻烦。

为什么需要它？

以往你要往媒体库添加一部新剧，得先打开 Sonarr 或 Radarr，进入对应页面，输入名称，选择质量规则、监控季数、设置根目录……如果不确定是电视剧还是电影，还得两边都查一遍。这个过程重复性高，且每次都要走相同步骤，容易出错，尤其是当你只是临时想到某部作品想快速入库时，流程显得过于沉重。

GPTDARR 解决的就是这种“小动作大流程”的问题。它把 Sonarr 和 Radarr 的功能统一到一个可对话的入口中，你只需要说“加一部《Stranger Things》”，它就能自动判断类型、跨平台搜索、展示结果并完成添加。整个过程不需要打开网页界面，也不用手动复制粘贴标题或校验ID。

💡 核心能力速览

统一搜索与添加：
工具会同时查询 Sonarr 和 Radarr 的数据库，返回匹配结果。你可以直接选择目标条目，系统自动调用对应服务的 API 完成添加，避免在两个系统之间反复切换。

交互式初始化配置：
运行 npx gptdarr setup 后，工具会引导你输入 Sonarr 和 Radarr 的地址、API 密钥、默认下载路径等信息。每一步都有提示，配置完成后自动生成本地配置文件，无需手动编辑 JSON 或环境变量。

操作日志透明化：
所有与 Sonarr 和 Radarr 的 API 通信都会被记录，包括请求参数、响应状态和错误详情。当添加失败或返回异常时，你能快速查看哪一步出了问题，而不是面对一个无反馈的操作结果。

⚙️ 适合谁？怎么用？

如果你已经在用 Sonarr 或 Radarr 管理电视剧和电影，并且希望用更少的操作完成日常维护，比如快速入库、批量查找或远程管理，那么 GPTDARR 能融入你的现有流程。它特别适合那些使用支持 MCP 的聊天工具（如集成 MCP 的 AI 客户端）进行日常任务管理的用户。

建议从简单的“单条添加”开始尝试，确认配置无误后，再逐步接入更复杂的查询或批量操作。由于它依赖外部 API 通信，保持网络连通性和 API 密钥的有效性是稳定运行的前提。对于熟悉命令行但不想重复写脚本的人来说，这是一个轻量且可扩展的选择。