Sonarr MCP Server

Sonarr MCP サーバー

これは、Sonarr にアクセスするための Model Context Protocol（MCP）サーバーです。Sonarr とプログラムからやり取りするためのツールを提供します。

前提条件

• Node.js >= 20
• 実行中の Sonarr インスタンス（v3 または v4）
• Sonarr API キー（Sonarr UI の Settings > General > API Key にあります）

ツール

以下のツールを利用できます。

ツール	説明	読み取り専用
search-series	検索語句でテレビシリーズを検索します	はい
find-episodes	シリーズのエピソードを検索します	はい
get-logs	Sonarr のログをページ単位で取得します	はい
list-recent-downloads	最近のダウンロード履歴を一覧表示します	はい
list-upcoming-episodes	カレンダーから今後のエピソードを一覧表示します	はい
add-series	Sonarr にシリーズを追加します	いいえ

ツール呼び出しの例

シリーズを検索する：

{ "term": "Severance" }

エピソードを検索する：

{ "seriesId": 123, "seasonNumber": 1 }

シリーズを追加する：

{
  "title": "Severance",
  "tvdbId": 371980,
  "qualityProfileId": 1,
  "rootFolderPath": "/tv"
}

リソース

以下のリソースを利用できます。

• sonarr://series/{id} - ID を指定して特定のシリーズの情報を取得します
• sonarr://episode/{id} - ID を指定して特定のエピソードの情報を取得します
• sonarr://quality-profile - Sonarr で設定されている品質プロファイルを一覧表示します
• sonarr://quality-definition - Sonarr で使用される品質定義を一覧表示します

設定

.env ファイルを作成するか、環境変数を設定します。

SONARR_URL=http://localhost:8989
SONARR_API_KEY=your-api-key-here

使用方法

Claude Desktop / MCP クライアントでの使用

このサーバーを MCP 設定に追加します。

{
  "mcpServers": {
    "sonarr": {
      "command": "npx",
      "args": ["-y", "sonarr-mcp"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "<your-sonarr-api-key>"
      }
    }
  }
}

ローカル開発

npm install
npm run build
npm run test
npm run lint

stdio トランスポートを使用してローカルで実行します。

SONARR_URL=http://localhost:8989 SONARR_API_KEY=xxx npm start

セキュリティ

• SONARR_API_KEY は非公開にしてください。パスワードと同様に扱ってください。
• API キーを含む .env ファイルをコミットしないでください。
• サーバーは HTTP(S) 経由で Sonarr と通信します。Sonarr を外部に公開する場合は HTTPS を使用してください。

トラブルシューティング

問題	考えられる原因	解決策
"fetch failed" または接続エラー	SONARR_URL が誤っています	URL と Sonarr が実行中であることを確認してください
"Sonarr HTTP 401"	API キーが無効です	Sonarr の設定で API キーを確認してください
"Invalid environment variables"	必須の環境変数が不足しています	SONARR_URL と SONARR_API_KEY の両方を設定してください