Integrations

Offers Docker deployment support with a pre-configured Docker image, allowing containerized execution of the IMDb MCP server with proper environment variable configuration.
Provides comprehensive access to IMDb movie and TV show data, including search capabilities, detailed information about titles, cast and crew details, top-rated content lists, box office data, upcoming releases, and country-specific movie information with special focus on Indian cinema.
Utilizes RapidAPI's IMDb API service to fetch movie and TV show information, requiring users to set up a RapidAPI account and subscribe to the IMDb API to obtain the necessary API key.

IMDb MCP 서버

IMDb API 서비스를 사용하여 영화 및 TV 쇼 정보를 위한 MCP(모델 컨텍스트 프로토콜)를 구현하는 Python 서버입니다.

개요

이 서버는 IMDb API를 통해 IMDb 데이터에 접근할 수 있는 포괄적인 도구 세트를 제공합니다. 에이전트와 IMDb 데이터베이스를 연결하는 다리 역할을 하며, 영화, TV 프로그램, 배우, 감독 등에 대한 자세한 정보를 제공합니다.

특징

🎬 영화 및 TV 프로그램 검색 기능
📋 영화 및 TV 프로그램에 대한 자세한 정보
👨‍👩‍👧‍👦 출연진 및 제작진 정보
🏆 최고 평점 및 인기 콘텐츠 목록
💰 박스오피스 데이터
🌍 국가별 영화 정보(특히 인도 영화에 초점)
🔜 곧 출시 예정
🔄 효율적인 응답 캐싱 시스템

구성

이 서버에는 IMDb API 서비스를 위한 RapidAPI의 API 키가 필요합니다.

RapidAPI 에 계정을 만드세요
RapidAPI에서 IMDb API 구독하기
환경 변수를 설정합니다.지엑스피1

도구

검색 도구

도구	설명	예
검색_imdb	다양한 필터링 옵션으로 영화와 TV 프로그램을 검색하세요	`search_imdb(primary_title="Inception")`

IMDb ID 도구

도구	설명	예
get_imdb_details	영화나 TV 쇼에 대한 자세한 정보를 검색하세요	`get_imdb_details(imdb_id="tt1375666")`
get_directors	영화 감독 검색	`get_directors(imdb_id="tt1375666")`
get_cast	영화 출연진 검색	`get_cast(imdb_id="tt1375666")`
get_writers	영화 작가를 검색하세요	`get_writers(imdb_id="tt1375666")`

구성 도구

도구	설명	예
get_types	사용 가능한 모든 콘텐츠 유형을 가져옵니다.	`get_types()`
장르 가져오기	사용 가능한 모든 장르를 얻으세요	`get_genres()`
국가 가져오기	사용 가능한 모든 국가를 확인하세요	`get_countries()`
get_languages	사용 가능한 모든 언어를 가져옵니다	`get_languages()`

영화 도구

페이지 번호 매기기(페이지당 5개 결과)

도구	설명	예
인기_250_영화를_얻다	IMDb에서 가장 인기 있는 영화 250편을 받아보세요	`get_top_250_movies()`
탑박스오피스를 받으세요	미국 박스오피스 기록을 알아보세요	`get_top_box_office_us()`
가장 인기 있는 영화 보기	가장 인기 있는 영화를 받아보세요	`get_most_popular_movies()`

TV 프로그램 도구

페이지 번호 매기기(페이지당 5개 결과)

도구	설명	예
인기_250_TV_쇼를_얻다	IMDb에서 가장 인기 있는 TV 프로그램 250개를 확인하세요	`get_top_250_tv_shows()`
가장 인기 있는 TV 프로그램 보기	가장 인기 있는 TV 프로그램을 받아보세요	`get_most_popular_tv_shows()`

곧 출시될 도구

페이지 번호 매기기(페이지당 5개 결과)

도구	설명	예
곧 출시될 릴리스를 받으세요	국가별 개봉 예정 영화 및 TV 프로그램 정보를 받아보세요	`get_upcoming_releases(country_code="US", type="MOVIE")`
곧 출시될 출시 상품에 대한 사용 가능한 국가 코드를 받으세요	출시 예정인 제품에 대한 사용 가능한 국가 코드를 확인하세요.	`get_available_country_codes_for_upcoming_releases()`

인도 스포트라이트 도구(페이지별)

페이지 번호 매기기(페이지당 5개 결과)

도구	설명	예
최고 평점 말라얄람어 영화 보기	상위 50개 말라얄람어 영화를 감상하세요	`get_top_rated_malayalam_movies()`
곧 개봉하는 인도 영화	가장 기대되는 인도 영화를 만나보세요	`get_upcoming_indian_movies()`
인기 있는 타밀어 영화 보기	인기 타밀어 영화를 감상하세요	`get_trending_tamil_movies()`
인기 있는 텔루구 영화 보기	인기 있는 텔루구 영화를 감상하세요	`get_trending_telugu_movies()`
최고 평점 타밀어 영화 보기	상위 50개 타밀어 영화를 감상하세요	`get_top_rated_tamil_movies()`
최고 평점 텔루구 영화 보기	상위 50개 텔루구 영화를 감상하세요	`get_top_rated_telugu_movies()`
최고 평점 인도 영화 보기	상위 250개 인도 영화를 감상하세요	`get_top_rated_indian_movies()`

예시 프롬프트 및 응답

가까운 미래에 개봉될 액션 영화 5편은 무엇입니까?

다가오는 액션 영화를 찾아드릴게요.

MCP 도구 get_upcoming_releases 라고 합니다.

이제 다가올 개봉작의 액션 영화를 찾아보겠습니다.

MCP 도구 get_upcoming_releases 라고 합니다.

검색 결과를 바탕으로, 가까운 미래에 개봉될 예정인 액션 영화 5편은 다음과 같습니다.

마인크래프트 영화 (2025년 4월 4일)
- 장르: 액션, 모험, 코미디
- 설명: 4명의 괴짜들이 차원문을 통해 큐브형 원더랜드로 끌려가 전문 장인과 함께 집으로 돌아가기 위한 탐구에 나선다.
기괴한 이야기 (2025년 4월 4일)
- 장르: 액션, 모험, 코미디
- 설명: 1987년 캘리포니아주 오클랜드를 배경으로 음악, 영화, 사람, 장소, 추억에 대한 사랑을 다룬 4개의 연결된 이야기입니다.
깨어나라 (2025년 4월 4일)
- 장르: 액션, 공포
- 설명: 젊은 활동가들이 환경 문제에 항의하기 위해 가구 매장에 침입하지만 사냥에 집착하는 야간 경비원에게 갇히게 됩니다.
전쟁 (2025년 4월 11일)
- 장르: 액션, 드라마, 전쟁
- 설명: 이라크 전쟁 당시 해군 특수부대 출신 레이 멘도자의 실제 경험을 바탕으로 한 작품입니다.
아마추어 (2025년 4월 11일)
- 장르: 액션, 스릴러
- 설명: CIA 암호학자가 아내를 죽인 테러리스트를 추적하도록 자신을 훈련시키라고 자신의 기관을 협박한다.

설치

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 IMDb Server를 자동으로 설치하는 방법:

npx -y @smithery/cli install @uzaysozen/imdb-mcp-server --client claude

옵션 1: Docker 사용(권장)

이 저장소를 복제하세요

git clone https://github.com/uzaysozen/imdb-mcp-server.git
cd imdb-mcp-server

종속성 설치

pip install -r requirements.txt

Docker 이미지 빌드

docker build -t imdb_server .

Docker 컨테이너를 실행합니다(API 키가 환경 변수로 전달되었는지 확인하세요)

docker run -d -p 8000:8000 -e RAPID_API_KEY_IMDB=your_api_key_here --name imdb_server imdb_server

claude_desktop_config.json 에 다음을 추가하세요:

{
  "mcpServers": {
    "imdb_server": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "imdb_server",
        "imdb-mcp-server"
      ],
      "env": {
        "RAPID_API_KEY_IMDB": "your_api_key_here"
      }
    }
  }
}

옵션 2: 직접 Python 실행

이 저장소를 복제하세요

git clone https://github.com/uzaysozen/imdb-mcp-server.git
cd imdb-mcp-server

종속성 설치

pip install -r requirements.txt

API 키 환경 변수 설정

export RAPID_API_KEY_IMDB=your_api_key_here

필요에 따라 Python 경로를 조정하여 claude_desktop_config.json 에 다음을 추가합니다.

{
  "mcpServers": {
    "imdb_server": {
      "command": "/path/to/your/python",
      "args": [
        "/path/to/imdb_server.py"
      ],
      "env": {
        "RAPID_API_KEY_IMDB": "your_api_key_here"
      }
    }
  }
}

서버 시작

# Start the server directly
python imdb_server.py

# Or using MCP CLI
mcp run imdb_server.py

# Or if using Docker, the server starts automatically with the container
docker run -d -p 8000:8000 -e RAPID_API_KEY_IMDB=your_api_key_here --name imdb_server imdb_server

선택한 구성을 추가한 후 Claude Desktop을 다시 시작하여 IMDb 서버를 로드하세요. 그러면 Claude와 대화할 때 모든 영화 및 TV 프로그램 데이터 도구를 사용할 수 있습니다.

기술적 세부 사항

서버는 다음을 기반으로 구축되었습니다.

RapidAPI를 통한 IMDb API
API 인터페이스를 위한 MCP
API 통신 요청
서버 구현을 위한 FastMCP
사용자 정의 메모리 내 캐싱 시스템
요청당 5개 항목으로 결과를 제한하는 스마트 페이지네이션으로 AI 에이전트 소비를 최적화합니다.

페이지네이션 시스템

모든 데이터 검색 도구는 AI 에이전트 성능을 향상시키기 위해 페이지 분할을 구현합니다.

목적

AI 최적화된 응답 : 각 응답을 5개 항목으로 제한하여 데이터를 처리하는 AI 에이전트의 과부하를 방지합니다.
집중된 결과 : 에이전트가 사용자에게 더욱 관련성 있고 간결한 정보를 제공하는 데 도움이 됩니다.
향상된 처리 : 영화 및 TV 프로그램 데이터를 분석할 때 AI 에이전트의 인지 부하를 줄입니다.

구현

각 페이지 분할 엔드포인트는 start 매개변수를 허용합니다(기본값: 0)
결과에는 탐색 메타데이터(totalCount, hasMore, nextStart)가 포함됩니다.
모든 컬렉션 엔드포인트에서 일관된 5개 항목 페이지 크기
페이지 매김을 사용한 요청 예: get_top_250_movies(start=5) 6-10번째 항목을 반환합니다.

이익

더 나은 에이전트 응답 : AI 에이전트가 한 번에 너무 많은 데이터를 수신하는 것을 방지합니다.
관리 가능한 정보 : 에이전트가 효과적으로 처리할 수 있는 소화 가능한 데이터 청크를 생성합니다.
순차적 액세스 : 여러 도구 호출을 통해 대규모 데이터 세트의 체계적인 탐색을 허용합니다.

캐싱 시스템

서버는 성능을 개선하고 API 호출을 줄이기 위해 효율적인 캐싱 시스템을 구현합니다.

특징

메모리 내 캐시 : 빠른 검색을 위해 API 응답을 메모리에 저장합니다.
구성 가능한 만료 및 크기 : 캐시 항목은 사용자 지정 가능한 기간(기본값: 10분) 후에 만료되며 기본 크기는 100개의 캐시 키입니다.
자동 캐시 정리 : 주기적으로(기본값: 5분) 백그라운드 스레드를 사용하여 메모리 사용을 관리하기 위해 만료된 항목을 제거합니다.
캐시 키 : 고유성을 보장하기 위해 URL 및 쿼리 매개변수를 기반으로 생성됩니다.

이익

API 사용량 감소 : 응답을 재사용하여 API 속도 제한 내에 머무르는 데 도움이 됩니다.
더 빠른 응답 시간 : 캐시된 쿼리에 대한 네트워크 지연을 제거합니다.
비용 효율성 : 특히 인기 있거나 반복되는 쿼리의 경우 API 호출 수를 최소화합니다.

구성

캐시 크기와 만료 시간은 코드에서 조정할 수 있습니다.

# Default are 600 seconds (10 minutes) and 100 cache keys
response_cache = ResponseCache(expiry_seconds=120, max_size=50)

제한 사항

RapidAPI 구독에 따라 API 속도 제한이 적용됩니다.
일부 세부 정보에는 추가 API 호출이 필요할 수 있습니다.
검색 결과는 요청당 특정 수의 항목으로 제한될 수 있습니다.
서버가 다시 시작되면 메모리 내 캐시가 손실됩니다.
모든 페이지별 응답은 페이지당 최대 5개 항목을 반환합니다.

문제 해결

문제	해결책
API 키가 인식되지 않습니다	RAPID_API_KEY_IMDB 환경 변수가 올바르게 설정되었는지 확인하세요.
요금 제한을 초과했습니다	RapidAPI 구독 등급 및 제한 사항을 확인하세요.
시간 초과 오류	서버의 시간 초과는 30초입니다. 대량 요청의 경우 매개변수를 제한해 보세요.
빈 결과	더 광범위한 검색어를 사용해 보거나 해당 콘텐츠가 IMDb 데이터베이스에 있는지 확인하세요.
메모리 사용량이 높음	많은 고유 쿼리로 장기간 실행하는 경우 가끔씩 서버를 다시 시작하여 캐시를 지우십시오.

특허

이 MCP 서버는 MIT 라이선스에 따라 제공됩니다.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

영화, TV 프로그램, 곧 출시될 영화 등을 포함한 자세한 IMDb 데이터를 제공하는 포괄적인 MCP 서버입니다.

imdb-mcp-server

Integrations

IMDb MCP 서버

목차

개요

특징

구성

도구

검색 도구

IMDb ID 도구

구성 도구

영화 도구

TV 프로그램 도구

곧 출시될 도구

인도 스포트라이트 도구(페이지별)

예시 프롬프트 및 응답

설치

Smithery를 통해 설치

옵션 1: Docker 사용(권장)

옵션 2: 직접 Python 실행

서버 시작

기술적 세부 사항

페이지네이션 시스템

목적

구현

이익

캐싱 시스템

특징

이익

구성

제한 사항

문제 해결

특허

Appeared in Searches