TMDB MCP 서버

이 프로젝트는 영화 데이터베이스(TMDB) API와 통합되는 모델 컨텍스트 프로토콜(MCP) 서버를 구현합니다. 이를 통해 클로드와 같은 AI 비서가 영화 데이터와 상호 작용하여 영화 관련 콘텐츠를 검색하고, 세부 정보를 가져오고, 생성하는 기능을 제공합니다.

특징

자원

• 정적 리소스 :

  • tmdb://info - TMDB API에 대한 정보

  • tmdb://trending - 현재 인기 있는 영화

• 리소스 템플릿 :

  • tmdb://movie/{id} - 특정 영화에 대한 자세한 정보

프롬프트

• 영화 리뷰 : 지정된 스타일과 등급으로 맞춤형 영화 리뷰를 생성합니다.

• 영화 추천 : 장르와 분위기에 따라 개인화된 영화 추천을 받으세요

도구

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

• 인기 영화 보기 : 하루 또는 주간 인기 영화 검색

• 비슷한 영화 찾기 : 특정 영화와 비슷한 영화 찾기

설치 지침

필수 조건

• Node.js(v16 이상)

• npm 또는 yarn

• TMDB API 키

설치

1. 이 저장소를 복제하세요

   지엑스피1

2. 종속성 설치

   npm install

3. TMDB API 키 구성

   • 프로젝트 루트에 .env 파일을 만듭니다(대안: src/config.ts 직접 편집합니다)

   • TMDB API 키를 추가하세요: TMDB_API_KEY=your_api_key_here

4. 프로젝트를 빌드하세요

   npm run build

5. 서버를 시작합니다

   npm start

Claude Desktop 설정

1. 클로드 데스크톱 열기

2. 설정 > 개발자 탭으로 이동하세요

3. "구성 편집"을 클릭하여 구성 파일을 엽니다.

4. 구성에 다음을 추가하세요.

5. Claude Desktop을 다시 시작하세요

사용 예

정적 리소스 사용

• "TMDB란 무엇인가요?"

• "현재 인기 있는 영화 보여줘"

리소스 템플릿 사용

• "ID 550 영화에 대한 자세한 정보를 얻으세요"(파이트 클럽)

• "ID 155가 나오는 영화에 대해 말해줘"(다크 나이트)

프롬프트 사용

• "Inception에 대한 자세한 리뷰를 9/10점으로 작성하세요"

• "생각이 깊어지는 SF 영화를 추천해 주세요"

도구 사용

• "우주 탐사에 관한 영화를 검색하세요"

• "요즘 인기 영화는 뭐야?"

• "매트릭스와 비슷한 영화 찾기"

개발

프로젝트 구조

테스트

개발 중에 MCP Inspector를 사용하여 서버를 테스트하세요.

특허

MIT

감사의 말

• 영화 데이터베이스(TMDB)

• 모델 컨텍스트 프로토콜