Skip to main content
Glama
Sign In
enesjakozh

Overseerr MCP Server

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

監督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

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.

Tools

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

  1. 会話の例
    1. 特徴
      1. メディア検索
      2. メディアリクエスト
      3. 統合
    2. 設定
      1. 前提条件
      2. クイックスタート
    3. 技術的な詳細
      1. プロジェクト構造
      2. 利用可能なツール
      3. 構成
      4. エラー処理
    4. 貢献
      1. ライセンス

        Related Resources

        Related MCP Servers

        • Needle MCP Serverofficial

          needle-ai
          A
          security
          A
          license
          A
          quality
          A server that allows users to manage documents and perform Claude-powered searches using Needle through the Claude Desktop application.
          Last updated -
          7
          39
          Python
          MIT License
          • Apple

        • MCP Server for FTP Access

          alxspiker
          A
          security
          F
          license
          A
          quality
          Enables Claude to interact with FTP servers through natural language commands, allowing users to list directories, download/upload files, create directories, and delete files/directories on FTP servers.
          Last updated -
          6
          5
          JavaScript
          • Linux
          • Apple

        • Inkeep MCP Serverofficial

          inkeep
          -
          security
          A
          license
          -
          quality
          A server that connects Claude to your documentation via Inkeep's API, enabling AI-powered interactions with your documentation content.
          Last updated -
          5
          Python
          MIT License
          • Apple
          • Linux

        • Readwise MCP Server

          IAmAlexander
          -
          security
          A
          license
          -
          quality
          Enables access and interaction with your Readwise library, allowing you to retrieve and search highlights, books, and documents through natural language queries when using Claude or other MCP-compatible assistants.
          Last updated -
          2
          TypeScript
          MIT License

        View all related MCP servers

        Appeared in Searches

        New MCP Servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/jmagar/overseerr-mcp-server'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server