arr_mcp

ARR-MCP 是一个 MCP（模型上下文协议）服务器，可将 Claude、Cursor 和 VS Code 等 AI 助手连接到 *Arr 媒体栈，包括 Sonarr、Radarr、Prowlarr、Bazarr、qBittorrent 和 NZBGet。它支持每个服务的多个实例，允许用户运行单独的配置（例如 4K 和 1080p 的 Sonarr 实例），并按名称进行寻址。 该服务器基于官方 Go SDK 构建，通过 stdio 和 Streamable HTTP 使用 JSON-RPC 2.0 实现真正的 MCP。它在所有受支持的服务中提供 246 个工具，使用户能够执行原本需要通过每个服务 Web UI 完成的任务。这些工具涵盖库管理、搜索和导入操作、质量配置文件配置、提供者管理以及系统操作。 主要功能包括： - 多实例支持，具有命名实例和默认选择功能 - 权限控制，具有三种模式：只读、确认（默认）和完全访问 - 针对写入或破坏性操作的确认范围设置 - 针对不支持 elicitation 的客户端的回退行为 - 单一静态二进制文件，支持 distroless 容器和多架构镜像 - 包含 Kubernetes 部署清单 可以通过环境变量为单个实例进行配置，或通过 config.yaml 文件为多个实例进行配置。配置文件支持通过环境变量引用密钥，因此可以安全地提交或从 ConfigMap 挂载。服务器在启动时验证配置，在操作期间捕获错误之前先发现错误。 工具按服务和访问类型（读取、写入、破坏性）组织。Sonarr 和 Radarr 保持 62 个公共工具名称的一致性。Bazarr 提供字幕管理工具，Prowlarr 处理索引器管理和发布抓取，而 qBittorrent 和 NZBGet 分别提供 torrent 和 Usenet 下载客户端功能。 服务器包含健康检查，支持 stdio 和 HTTP 传输，并为各种 MCP 客户端提供可复制粘贴的配置。响应负载被投影为仅包含相关字段，而不是完整的上游数据，从而保持响应可管理，同时提供决策所需的信息。