mcp-arr-lite

Radarr 및 Sonarr를 위한 경량 MCP 서버로, 소수의 세분화되고 목적에 맞게 제작된 도구를 제공합니다. 비공식 프로젝트입니다.

이 프로젝트를 만든 이유?

일반적인 "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 (컨테이너)

• API 키를 가진 Radarr 및/또는 Sonarr

설치

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 인증, 속도 제한(분당 IP당 60회 요청) 및 1 MB 본문 제한을 적용합니다.

• API 키는 로그에서 가려집니다.

• HTTP 전송은 MCP_AUTH_TOKEN을 설정하고 TLS 종료 리버스 프록시 뒤에서만 실행하세요.

라이선스

MIT