FastMCP server for Overseerr

Seerr 用 FastMCP サーバー

fastmcp ライブラリを使用して構築された、映画やテレビ番組のリクエスト管理のために Seerr API と連携する FastMCP サーバーです。

プロジェクトリポジトリ：https://github.com/ptbsare/seerr-mcp-server

コンポーネント

ツール

このサーバーは、Seerr と連携するために以下のツールを実装しています。

• seerr_status：Seerr サーバーのステータスを取得します。
• seerr_movie_requests：映画リクエストのページ分割された一覧を取得します。status、start_date（YYYY-MM-DDTHH:MM:SS.mmmZ 形式）、take（デフォルトは 7）、skip（デフォルトは 0）を任意で指定できます。
• seerr_tv_requests：テレビ番組リクエストのページ分割された一覧を取得します。status、start_date（YYYY-MM-DDTHH:MM:SS.mmmZ 形式）、take（デフォルトは 7）、skip（デフォルトは 0）を任意で指定できます。
• seerr_request_movie_to_library：TMDB ID を使用して、特定のユーザーに代わって特定のライブラリに映画をリクエストします。tmdb_id、library_name、user_display_name が必要です。利用可能なライブラリ名とユーザーの表示名（重複を除く）はサーバーの起動時に取得され、ツールの引数の説明に含まれます。
• seerr_request_tv_to_library：TMDB ID を使用して、特定のユーザーに代わって特定のライブラリにテレビ番組をリクエストします。tmdb_id、library_name、user_display_name が必要です。任意で seasons（整数のリスト）を指定できます。利用可能なライブラリ名とユーザーの表示名（重複を除く）はサーバーの起動時に取得され、ツールの引数の説明に含まれます。
• seerr_search_media：Seerr で利用可能な映画やテレビ番組を検索します。query と、任意で page（デフォルトは 1）を指定できます。
• seerr_get_available_libraries：Seerr から、設定済みの Sonarr（テレビ）および Radarr（映画）サーバーの ID と名前を取得します。
• seerr_get_users：Seerr に設定されているすべてのユーザーの一覧を、ID、ユーザー名、メールアドレス、displayName などの情報とともに取得します。

プロンプトの例

まず AI アシスタント（例：Claude）に Seerr のツールを使うよう指示しておくと便利です。必要に応じて、適切なツールを呼び出せるようになります。

次のようなプロンプトを試してください。

• Seerr サーバーのステータスを取得してください。
• 現在保留中の映画リクエストを最初の 5 件表示してください。
• 2024-01-01 以降のテレビ番組リクエストのうち、現在利用可能なものをすべて一覧表示してください。
• リクエスト済みで、まだ利用できない映画を教えてください。
• 最近ライブラリで利用可能になったテレビ番組を教えてください。
• Seerr で映画「Dune: Part Two」を検索してください。
• Seerr に設定されている映画ライブラリとテレビ番組ライブラリを教えてください。
• Seerr のすべてのユーザーを一覧表示してください。
• 「Movies HD」ライブラリで、ユーザー「John Doe」のために TMDB ID 693134 の映画をリクエストしてください。（user_display_name='John Doe'、library_name='Movies HD' を使用）
• 「TV Shows 4K」ライブラリで、ユーザー「Jane Smith」のために TMDB ID 1396 のテレビ番組のシーズン 1 と 2 をリクエストしてください。（user_display_name='Jane Smith' を使用）

クイックスタート

前提条件

• uv（インストール手順：https://github.com/astral-sh/uv）
• Seerr インスタンスが稼働していること。
• Seerr インスタンスの API キー（Settings → API Keys）。

uvx で実行（推奨 — インストール不要）

クローンやインストールを行わずに、uvx を使って Git リポジトリからサーバーを直接実行できます。

uvx --from git+https://github.com/ptbsare/seerr-mcp-server.git seerr-mcp-server

Claude Desktop の設定

以下を claude_desktop_config.json に追加してください。

{
  "mcpServers": {
    "seerr-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/ptbsare/seerr-mcp-server.git",
        "seerr-mcp-server"
      ],
      "env": {
        "SEERR_API_KEY": "<your_api_key_here>",
        "SEERR_URL": "<your_seerr_url>"
      }
    }
  }
}

<your_api_key_here> と <your_seerr_url> を、実際の Seerr API キーと URL に置き換えてください。

環境変数

以下の環境変数が必要です。

• SEERR_API_KEY：Seerr API キー（Seerr の Settings → API Keys で確認できます）
• SEERR_URL：Seerr インスタンスの URL（例：http://localhost:5055）

Claude Desktop などのクライアントでは、上記のように env フィールドにこれらを追加してください。ローカルで使用する場合は、環境変数としてエクスポートするか、.env ファイルを使用できます。

SEERR_API_KEY=your_api_key_here
SEERR_URL=http://localhost:5055

ローカル開発環境へのインストール

開発用にローカルへインストールする場合は、以下の手順に従ってください。

git clone https://github.com/ptbsare/seerr-mcp-server.git
cd seerr-mcp-server
uv venv
source .venv/bin/activate # On Windows use `.venv\Scripts\activate`
uv pip install -e .

開発

セットアップ

uv pip install -e . を使用して編集可能インストールを行い、インストール手順に従ってください。

依存関係

uv を使用して依存関係をインストールまたは同期します。

uv sync
# or
uv pip install -e .

デバッグ

MCP サーバーは stdio 経由で実行されるため、デバッグが難しい場合があります。

• MCP Inspector： MCP Inspector の使用を強くおすすめします。

  サーバースクリプトを指定して起動します。

  # uvx を使用する場合（ローカルへのインストールは不要）
  npx @modelcontextprotocol/inspector uvx --from git+https://github.com/ptbsare/seerr-mcp-server.git seerr-mcp-server
  
  # uv run を使用する場合（ローカルのプロジェクトディレクトリから）
  npx @modelcontextprotocol/inspector uv run seerr-mcp-server
  

  ブラウザーで Inspector が表示する URL にアクセスしてください。

• ログ： サーバーは基本的な情報を stdout/stderr に記録します。uv run seerr-mcp-server を実行したターミナルを確認してください。Claude Desktop などのクライアントでは、クライアントのログファイルを確認してください（例：macOS では ~/Library/Logs/Claude/mcp-server-seerr-mcp.log。ただし、名前は設定によって異なる場合があります）。

ライセンス

MIT