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 トランスポートはベアラー認証、レート制限（60 req/min/IP）、および 1 MB の本文サイズ制限を強制します。

• API キーはログからマスクされます。

• HTTP トランスポートは、MCP_AUTH_TOKEN を設定し、TLS 終端リバースプロキシの背後でのみ実行してください。

ライセンス

MIT