Skip to main content
Glama

Overseerr MCP Server

감독관 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

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.

Claude가 Overseer와 상호 작용할 수 있도록 하여 사용자가 자연어로 Plex 라이브러리의 미디어를 검색, 요청, 관리할 수 있도록 합니다.

  1. 대화 예시
    1. 특징
      1. 미디어 검색
      2. 미디어 요청
      3. 완성
    2. 설정
      1. 필수 조건
      2. 빠른 시작
    3. 기술적 세부 사항
      1. 프로젝트 구조
      2. 사용 가능한 도구
      3. 구성
      4. 오류 처리
    4. 기여하다
      1. 특허

        Related MCP Servers

        • 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
        • 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
        • -
          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
        • -
          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

        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