mcp-server-tmdb

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

필수 계정 및 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 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

기여하다

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