TMDB MCP 서버

이 MCP 서버는 TMDB(The Movie Database) API와 통합되어 영화 정보, 검색 기능 및 추천을 제공합니다.

필수 조건

TMDB MCP 서버를 설치하고 실행하기 전에 다음 필수 구성 요소가 설치되고 구성되어 있는지 확인하세요.

필수 소프트웨어

• 노드.js

  • 버전 18.0.0 이상

  • Node.js 공식 웹사이트 에서 다운로드

  • 설치 확인: node --version

• npm(노드 패키지 관리자)

  • 버전 8.0.0 이상(Node.js와 함께 제공)

  • 설치 확인: npm --version

• 타입스크립트

  • 프로젝트 종속성으로 설치됩니다.

  • 전역적으로 설치 가능: npm install -g typescript

  • 설치 확인: tsc --version

Related MCP server: TMDB MCP Server

필수 계정 및 API 키

• TMDB 계정

  • TMDB 의 무료 계정

  • TMDB 대시보드의 API 키

  • API 액세스는 TMDB에서 승인되어야 합니다.

• 클로드 데스크톱 애플리케이션

  • 최신 버전 설치됨

  • 구성 파일을 수정하기 위한 액세스

시스템 요구 사항

• 운영 체제

  • macOS(10.15 이상)

  • Linux(최신 배포판)

• 하드웨어 요구 사항

  • 최소 4GB RAM

  • 1GB의 여유 디스크 공간

  • 안정적인 인터넷 연결

개발 환경

최상의 개발 경험을 위해 다음을 권장합니다.

• TypeScript를 지원하는 코드 편집기(예: VS Code)

• 터미널 접근

• Git(버전 제어용)

특징

도구

• 영화 검색

  • 제목이나 키워드로 영화 검색

  • 입력: query (문자열): 검색 쿼리

  • 반환: 제목, 개봉 연도, ID, 등급 및 개요가 포함된 영화 목록

  • 예: 우주 탐사에 관한 영화 검색

• 추천 받기

  • 영화 ID를 기반으로 영화 추천 받기

  • 입력: movieId (문자열): TMDB 영화 ID

  • 리턴즈: 추천 영화 Top 5 (자세한 내용 포함)

  • 예: 영화 ID 550(파이트 클럽)을 기준으로 추천을 받으세요.

• 트렌드 얻기

  • 지정된 기간 동안 인기 영화를 받아보세요

  • 입력: timeWindow (문자열): "day" 또는 "week"

  • 리턴즈: 세부 정보가 담긴 인기 영화 10선

  • 예: 오늘의 인기 영화 받기

자원

이 서버는 TMDB 영화 정보에 대한 액세스를 제공합니다.

• 영화 ( tmdb:///movie/<movie_id> )

  • 다음을 포함한 포괄적인 영화 세부 정보:

    • 제목 및 출시일

    • 평가 및 개요

    • 장르

    • 포스터 URL

    • 출연진 정보 (상위 5명의 배우)

    • 감독

    • 선택된 리뷰

  • 모든 데이터는 JSON 형식으로 반환됩니다.

시작하기

1. TMDB API 키 받기:

   • TMDB 에 가입하세요

   • 계정 설정으로 이동하세요

   • API 섹션으로 이동

   • 개발자용 API 키 요청

2. 프로젝트를 복제하고 설정합니다.

   지엑스피1

3. 서버를 빌드하세요:

   npm run build

4. 환경 변수를 설정하세요:

   export TMDB_API_KEY=your_api_key_here

Claude Desktop과 함께 사용

이 서버를 Claude Desktop과 통합하려면 앱의 서버 구성 파일( ~/Library/Application Support/Claude/config.json 에 위치)에 다음을 추가하세요.

/full/path/to 프로젝트 디렉토리의 실제 경로로 바꾸세요.

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 TMDB 서버를 자동으로 설치하려면:

사용 예

Claude Desktop으로 서버를 실행하면 다음과 같은 명령을 사용할 수 있습니다.

1. 영화 검색:

   "Search for movies about artificial intelligence"

2. 인기 영화 보기:

   "What are the trending movies today?" "Show me this week's trending movies"

3. 영화 추천 받기:

   "Get movie recommendations based on movie ID 550"

4. 영화 세부 정보 보기:

   "Tell me about the movie with ID 550"

오류 처리

서버에는 다음에 대한 포괄적인 오류 처리 기능이 포함되어 있습니다.

• 잘못된 API 키

• 네트워크 오류

• 잘못된 영화 ID입니다

• 잘못된 요청

오류 메시지는 Claude Desktop을 통해 사용자 친화적인 형식으로 반환됩니다.

개발

개발 중 변화를 살펴보려면:

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.