mcp-arr-lite

轻量级 MCP 服务器，用于 Radarr 和 Sonarr，提供少量精细、专用工具。非官方项目。

为什么有这个项目？

通用的“arr”MCP 服务器（如 Knuckles-Team/arr-mcp）会从 Arr API 自动生成数千个工具，并将整个接口交给 LLM。mcp-arr-lite 则相反：

• 精细工具：仅包含“能帮我下载 X 吗？”流程所需操作——查找、添加、搜索发布、下载——没有管理/配置噪音。

• 首选索引器逻辑：搜索工具默认使用数值优先级最低的索引器，确定性而非依赖提示。

• HITL 友好：只读工具（查找、列出索引器）可自动批准；添加/搜索/下载需要明确用户批准。

• 双传输方式：stdio（npx）和 HTTP（Docker）。

与 Knuckles-Team/arr-mcp 的比较

Related MCP server: overseerr-mcp

工具

要求

• Node.js >= 20 (npx) 或 Docker (容器)

• Radarr 和/或 Sonarr，并拥有 API 密钥

安装

Docker Compose（推荐）

services:
  arr-mcp:
    image: ghcr.io/cuti27/mcp-arr-lite:latest
    restart: unless-stopped
    environment:
      - RADARR_URL=http://radarr:7878
      - RADARR_API_KEY=your-radarr-api-key
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=your-sonarr-api-key
      - MCP_TRANSPORT=http
      - MCP_AUTH_TOKEN=your-secure-token-here
      - PORT=3000
      - HOST=0.0.0.0
      - LOG_LEVEL=info

仅配置你使用的应用——Radarr 和 Sonarr 在启动时都是可选的；未配置的应用的工具将返回错误。

stdio (npx)

RADARR_URL=http://radarr:7878 \
RADARR_API_KEY=... \
SONARR_URL=http://sonarr:8989 \
SONARR_API_KEY=... \
MCP_TRANSPORT=stdio \
npx -y @cuti27/mcp-arr-lite

环境变量

参见 .env.example。每个应用必需：RADARR_URL + RADARR_API_KEY，SONARR_URL + SONARR_API_KEY。当 MCP_TRANSPORT=http 时，需要 MCP_AUTH_TOKEN。

安全

• HTTP 传输强制使用 Bearer 认证、速率限制（60 请求/分钟/IP）和 1 MB 请求体限制。

• API 密钥在日志中被隐藏。

• 仅在设置了 MCP_AUTH_TOKEN 且位于 TLS 终止反向代理后面时运行 HTTP 传输。

许可证

MIT