Skip to main content
Glama
deenesjakoruzh
CT4nk3r

arrstack-mcp

by CT4nk3r
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

🎬 arrstack-mcp

AI 어시스턴트가 Sonarr, Radarr, Prowlarr, qBittorrent 및 Jellyfin 홈랩 미디어 스택을 제어할 수 있게 해주는 MCP 서버입니다.

Claude Desktop, Cursor, VS Code Copilot, OpenClaw 및 기타 MCP 호환 클라이언트와 함께 작동합니다.

데모

OpenClaw가 arrstack-mcp를 사용하여 미디어를 검색하고 다운로드하는 모습

Related MCP server: nas-mcp-server

기능

서비스

도구

Sonarr

시리즈 목록, 쇼 검색 및 추가, 예정된 에피소드, 다운로드 대기열

Radarr

영화 목록, 영화 검색 및 추가, 다운로드 대기열

Prowlarr

인덱서 목록/테스트, 릴리스 검색, 상태 확인

qBittorrent

토렌트 목록/일시 중지/재개/삭제, 마그넷 추가, 전송 통계

Jellyfin

라이브러리 목록, 최근 추가 항목, 시스템 정보

사용하는 서비스만 구성하세요. 구성되지 않은 서비스는 자동으로 건너뜁니다.

빠른 시작

옵션 1: Claude Desktop / Cursor / VS Code (stdio)

  1. 종속성 설치:

    pip install "mcp[cli]>=1.9.0" httpx

  2. MCP 클라이언트 구성에 추가 (예: claude_desktop_config.json):

    {
  "mcpServers": {
    "arrstack": {
      "command": "python",
      "args": ["/path/to/arrstack-mcp/server.py"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-api-key",
        "RADARR_URL": "http://localhost:7878",
        "RADARR_API_KEY": "your-api-key",
        "QBT_URL": "http://localhost:8080",
        "QBT_USER": "admin",
        "QBT_PASS": "your-password",
        "JELLYFIN_URL": "http://localhost:8096"
      }
    }
  }
}

  3. MCP 클라이언트를 다시 시작합니다. 완료!

옵션 2: Docker (HTTP 전송)

원격 설정이나 *arr 스택과 함께 실행할 때:

git clone https://github.com/ct4nk3r/arrstack-mcp.git
cd arrstack-mcp
cp .env.example .env
# Edit .env with your service URLs and API keys
docker compose up -d

서버는 Streamable HTTP 전송을 사용하여 8000 포트에서 실행됩니다.

OpenClaw에 연결

openclaw mcp set arrstack '{"url":"http://arrstack-mcp:8000/mcp","transport":"streamable-http"}'

다른 HTTP MCP 클라이언트에 연결

Streamable HTTP 전송을 사용하여 클라이언트를 http://<host>:8000/mcp로 지정하세요.

옵션 3: *arr 스택과 동일한 네트워크의 Docker

미디어 서비스가 Docker에서 실행 중인 경우, arrstack-mcp를 동일한 네트워크에 추가하세요:

services:
  arrstack-mcp:
    build: .
    container_name: arrstack-mcp
    ports:
      - "8000:8000"
    environment:
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=your-key
      - RADARR_URL=http://radarr:7878
      - RADARR_API_KEY=your-key
      - QBT_URL=http://qbittorrent:8080
      - QBT_USER=admin
      - QBT_PASS=your-password
      - JELLYFIN_URL=http://jellyfin:8096
    networks:
      - your-media-network

구성

모든 구성은 환경 변수를 통해 수행됩니다:

변수

필수 여부

설명

SONARR_URL

아니요

Sonarr 기본 URL (예: http://localhost:8989)

SONARR_API_KEY

Sonarr 사용 시

Sonarr API 키 (설정 → 일반)

RADARR_URL

아니요

Radarr 기본 URL (예: http://localhost:7878)

RADARR_API_KEY

Radarr 사용 시

Radarr API 키 (설정 → 일반)

QBT_URL

아니요

qBittorrent 웹 UI URL (예: http://localhost:8080)

QBT_USER

qBt 사용 시

qBittorrent 사용자 이름 (기본값: admin)

QBT_PASS

qBt 사용 시

qBittorrent 비밀번호

JELLYFIN_URL

아니요

Jellyfin 기본 URL (예: http://localhost:8096)

JELLYFIN_API_KEY

아니요

Jellyfin API 키 (선택 사항, 인증된 엔드포인트용)

PROWLARR_URL

아니요

Prowlarr 기본 URL (예: http://localhost:9696)

PROWLARR_API_KEY

Prowlarr 사용 시

Prowlarr API 키 (설정 → 일반)

사용 가능한 도구

Sonarr (TV 쇼)

도구

설명

sonarr_list_series

에피소드 수 및 디스크 사용량을 포함한 모든 시리즈 목록

sonarr_get_series

특정 시리즈에 대한 상세 정보 가져오기

sonarr_search

추가할 새 쇼 검색

sonarr_add_series

TVDB ID로 쇼 추가

sonarr_upcoming

예정된 에피소드 표시

sonarr_queue

현재 다운로드 대기열 표시

Radarr (영화)

도구

설명

radarr_list_movies

다운로드 상태를 포함한 모든 영화 목록

radarr_get_movie

특정 영화에 대한 상세 정보 가져오기

radarr_search

추가할 새 영화 검색

radarr_add_movie

TMDB ID로 영화 추가

radarr_queue

현재 다운로드 대기열 표시

Prowlarr (인덱서)

도구

설명

prowlarr_list_indexers

상태를 포함한 모든 인덱서 목록

prowlarr_test_indexer

특정 인덱서 연결 테스트

prowlarr_test_all_indexers

활성화된 모든 인덱서 테스트

prowlarr_search

인덱서 전체에서 릴리스 검색

prowlarr_health

시스템 상태 경고 확인

qBittorrent (다운로드)

도구

설명

qbt_list_torrents

진행률 및 속도를 포함한 토렌트 목록

qbt_torrent_details

상세 토렌트 정보 가져오기

qbt_add_magnet

마그넷 링크 추가

qbt_pause

토렌트 일시 중지

qbt_resume

토렌트 재개

qbt_delete

토렌트 삭제 (파일 포함 여부 선택 가능)

qbt_transfer_info

전체 전송 통계

Jellyfin (미디어 서버)

도구

설명

jellyfin_libraries

미디어 라이브러리 목록

jellyfin_recent

최근 추가된 항목

jellyfin_system_info

서버 버전 및 시스템 정보

전송 옵션

# stdio (default) — for Claude Desktop, Cursor, VS Code
python server.py

# Streamable HTTP — for Docker / remote
python server.py --transport streamable-http --port 8000

# SSE — legacy HTTP transport
python server.py --transport sse --port 8000

API 키 찾기

  • Sonarr: 설정 → 일반 → API 키

  • Radarr: 설정 → 일반 → API 키

  • Prowlarr: 설정 → 일반 → API 키

  • qBittorrent: 설정 → 웹 UI → 인증

  • Jellyfin: 대시보드 → API 키 → 추가

라이선스

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessWithin a week

Resources

Related MCP Connectors

Related MCP Servers

  • nas-mcp-server

    matthieurosset
    A
    license
    A
    quality
    D
    maintenance
    MCP server for managing a media server stack (Plex, Radarr, Overseerr, Bazarr, Prowlarr, Trakt.tv) using natural language to browse, request, and discover content.
    12
    MIT

  • mcparr

    PhillyUrbs
    A
    license
    Not graded
    quality
    D
    maintenance
    A self-hosted MCP gateway that lets AI assistants drive your media services like Radarr and Sonarr through a single authenticated endpoint.
    AGPL 3.0

  • mcp-homelab

    asvarnon
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that gives AI assistants real-time access to your homelab infrastructure. It enables querying node status, managing Docker containers, controlling Proxmox VMs, and inspecting OPNsense firewall state through natural conversation.
    2
    MIT