Skip to main content
Glama
Sign In
enesjakozh

Overseerr MCP Server

by jmagar
Verified
GitHub
TypeScript
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides tools for interacting with Overseerr, a request management and media discovery tool for Plex, allowing users to search for movies and TV shows, get detailed information about media, request media to be added to their library, and view and manage existing requests.

監督MCP

Overseerr 向けの Model Context Protocol (MCP) 統合により、Claude AI を介してメディアリクエストシステムとの自然言語によるインタラクションが可能になります。このサーバーでは、会話型言語を使用して映画やテレビ番組を検索したり、メディアをリクエストしたり、Overseerr インスタンスを管理したりできます。

会話の例

このサーバーを使用して Claude と行うことができる会話の例を以下に示します。

You: Can you find any recent sci-fi movies? Claude: Let me search for recent science fiction films... [Uses overseerr:search to find recent sci-fi movies] You: That looks good! Can you request the second one? Claude: I'll request that movie for you... [Uses overseerr:request to submit the media request] You: What TV shows are available about cooking? Claude: I'll search for cooking-related TV shows... [Uses overseerr:search with type='tv' to find cooking shows]

特徴

メディア検索

  • 映画、テレビ番組、人物を検索
  • 以下を含むメディアの詳細情報を取得します。
    • タイトルと発売日
    • プロット概要
    • 在庫状況
    • リクエストステータス
  • メディアの種類（映画/テレビ/人物）でフィルタリング
  • 自然言語クエリ（例：「最近の SF 映画を探す」または「ブレイキング・バッドのような番組を検索する」）

メディアリクエスト

  • 映画やテレビ番組をリクエストする
  • テレビ番組のシーズンを個別に指定する
  • リクエストステータスを追跡する
  • リクエストの更新に関する通知を受け取る
  • 自然言語リクエスト（例：「最新のバットマン映画をリクエストする」または「サクセッションをウォッチリストに追加する」）

統合

  • stdio トランスポートによるシームレスな Claude AI 統合
  • Overseerインスタンスとのリアルタイムインタラクション
  • 安全なAPIキーの取り扱い
  • レート制限とエラー処理
  • 環境変数による簡単な設定

設定

前提条件

  • Node.js
  • pnpm
  • クロードデスクトップ
  • 監督者インスタンス

クイックスタート

  1. 依存関係をインストールします:
pnpm install
  1. プロジェクトをビルドします。
pnpm build
  1. 環境を構成する:
# Copy template cp .env.template .env # Edit .env with your values OVERSEERR_URL=your_overseerr_url OVERSEERR_API_KEY=your_api_key
  1. Claude デスクトップを設定します。

Linux/Mac:

{ "overseerr": { "command": "node", "args": ["/path/to/overseerr/packages/server/dist/index.js"], "cwd": "/path/to/overseerr", "transport": { "type": "stdio" }, "env": { "OVERSEERR_URL": "your_overseerr_url", "OVERSEERR_API_KEY": "your_api_key" } } }

Windows (二重のバックスラッシュに注意):

{ "overseerr": { "command": "node", "args": ["C:\\path\\to\\overseerr\\packages\\server\\dist\\index.js"], "cwd": "C:\\path\\to\\overseerr", "transport": { "type": "stdio" }, "env": { "OVERSEERR_URL": "your_overseerr_url", "OVERSEERR_API_KEY": "your_api_key" } } }
  1. サーバーを起動します。
pnpm start

技術的な詳細

プロジェクト構造

packages/ ├── config/ # Configuration management ├── overseerr/ # Overseerr API client ├── server/ # MCP server implementation └── shared/ # Shared types and utilities

利用可能なツール

メディア検索 ( overseerr:search )

Overseerr データベースで映画、テレビ番組、人物を検索します。

{ // The search query - can be a title, person, or general description query: string, // Optional: Filter by type // - 'movie': Only search movies // - 'tv': Only search TV shows // - 'person': Only search people type?: 'movie' | 'tv' | 'person' }

クエリの例:

  • 「インセプションを探して」
  • 「2023年のテレビ番組を探す」
  • 「トム・ハンクス出演の映画を探す」

メディアリクエスト ( overseerr:request )

映画やテレビ番組をメディアライブラリに追加するようリクエストします。

{ // The TMDB ID of the media to request mediaId: number, // Type of media being requested // - 'movie': Request a movie // - 'tv': Request a TV show mediaType: 'movie' | 'tv', // Optional: For TV shows, specify which seasons to request // If not provided, requests all available seasons seasons?: number[] }

リクエストの例:

  • 映画をリクエストする：「マトリックスをリクエスト」
  • 特定のシーズンをリクエストする: 「The Office のシーズン 1～3 を追加」
  • 全シーズンをリクエスト: 「ブレイキング・バッドの全シリーズをリクエスト」

構成

環境変数

  • OVERSEERR_URL : OverseerrインスタンスのURL
  • OVERSEERR_API_KEY : Overseerr APIキー

エラー処理

サーバーは堅牢なエラー処理を実装しています。

  • 意味のあるメッセージ付きのAPIエラー
  • レート制限保護
  • リクエストの検証
  • 接続エラーの回復

貢献

  1. リポジトリをフォークする
  2. 機能ブランチを作成する
  3. 変更をコミットする
  4. ブランチにプッシュする
  5. プルリクエストを作成する

ライセンス

マサチューセッツ工科大学

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Tools

Claude が Overseerr と対話できるようにし、ユーザーが自然言語を使用して Plex ライブラリのメディアを検索、リクエスト、管理できるようにします。

  1. Example Conversations
    1. Features
      1. Media Search
      2. Media Requests
      3. Integration
    2. Setup
      1. Prerequisites
      2. Quick Start
    3. Technical Details
      1. Project Structure
      2. Available Tools
      3. Configuration
      4. Error Handling
    4. Contributing
      1. License

        Related Resources

        Appeared in Searches

        ID: vs6qmcl6bm