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

サーバーはポート 8000 でStreamable HTTPトランスポートを使用して実行されます。

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 Web 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 (テレビ番組)

ツール

説明

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: 設定 → Web 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