Overseerr MCP Server

by jmagar
Verified

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

Overseer용 모델 컨텍스트 프로토콜(MCP) 통합으로, Claude AI를 통해 미디어 요청 시스템과 자연어 상호작용을 지원합니다. 이 서버를 통해 영화 및 TV 프로그램 검색, 미디어 요청, 대화형 언어를 사용한 Overseer 인스턴스 관리가 가능합니다.

대화 예시

이 서버를 사용하여 Claude와 나눌 수 있는 대화의 예는 다음과 같습니다.

지엑스피1

특징

미디어 검색

  • 영화, TV 프로그램 및 인물 검색
  • 다음을 포함한 미디어에 대한 자세한 정보를 얻으세요.
    • 제목 및 출시일
    • 줄거리 개요
    • 가용성 상태
    • 요청 상태
  • 미디어 유형(영화/TV/인물)으로 필터링
  • 자연어 쿼리(예: "최근 SF 영화 검색" 또는 "브레이킹 배드와 같은 프로그램 검색")

미디어 요청

  • 영화 및 TV 프로그램 요청
  • TV 프로그램의 개별 시즌을 지정하세요
  • 추적 요청 상태
  • 요청 업데이트에 대한 알림 받기
  • 자연어 요청(예: "최신 배트맨 영화 요청" 또는 "내 시청 목록에 Succession 추가")

완성

  • stdio 전송을 통한 원활한 Claude AI 통합
  • Overseer 인스턴스와의 실시간 상호 작용
  • 안전한 API 키 처리
  • 속도 제한 및 오류 처리
  • 환경 변수를 통한 쉬운 구성

설정

필수 조건

  • 노드.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 Desktop 구성:

리눅스/맥:

{ "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 )

Overseer 데이터베이스에서 영화, TV 프로그램, 인물을 검색해 보세요.

{ // 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년 TV 프로그램 찾기"
  • "톰 행크스가 출연한 영화를 찾아보세요"

미디어 요청( overseerr:request )

영화나 TV 프로그램을 미디어 라이브러리에 추가해 달라고 요청하세요.

{ // 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 : Overseer 인스턴스 URL
  • OVERSEERR_API_KEY : Overseer API 키

오류 처리

서버는 강력한 오류 처리를 구현합니다.

  • 의미 있는 메시지가 포함된 API 오류
  • 속도 제한 보호
  • 요청 검증
  • 연결 오류 복구

기여하다

  1. 저장소를 포크하세요
  2. 기능 브랜치 생성
  3. 변경 사항을 커밋하세요
  4. 지점으로 밀어 넣기
  5. 풀 리퀘스트 만들기

특허

MIT

You must be authenticated.

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

Claude가 Overseer와 상호 작용할 수 있도록 하여 사용자가 자연어로 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
        ID: vs6qmcl6bm