Skip to main content
Glama
enesjakozh

imdb-mcp-server

by uzaysozen
GitHub
Python
MIT License
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

IMDb MCP 서버

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

목차

개요

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

특징

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

구성

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

  1. RapidAPI 에 계정을 만드세요
  2. RapidAPI에서 IMDb API 구독하기
  3. 환경 변수를 설정합니다.지엑스피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편은 다음과 같습니다.

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

설치

Smithery를 통해 설치

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

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

옵션 1: Docker 사용(권장)

  1. 이 저장소를 복제하세요
git clone https://github.com/uzaysozen/imdb-mcp-server.git cd imdb-mcp-server
  1. 종속성 설치
pip install -r requirements.txt
  1. Docker 이미지 빌드
docker build -t imdb_server .
  1. Docker 컨테이너를 실행합니다(API 키가 환경 변수로 전달되었는지 확인하세요)
docker run -d -p 8000:8000 -e RAPID_API_KEY_IMDB=your_api_key_here --name imdb_server imdb_server
  1. 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 실행

  1. 이 저장소를 복제하세요
git clone https://github.com/uzaysozen/imdb-mcp-server.git cd imdb-mcp-server
  1. 종속성 설치
pip install -r requirements.txt
  1. API 키 환경 변수 설정
export RAPID_API_KEY_IMDB=your_api_key_here
  1. 필요에 따라 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

How are these scores calculated?

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.

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

  1. 목차
    1. 개요
      1. 특징
        1. 구성
          1. 도구
            1. 검색 도구
            2. IMDb ID 도구
            3. 구성 도구
            4. 영화 도구
            5. TV 프로그램 도구
            6. 곧 출시될 도구
            7. 인도 스포트라이트 도구(페이지별)
          2. 예시 프롬프트 및 응답
            1. 설치
              1. Smithery를 통해 설치
              2. 옵션 1: Docker 사용(권장)
              3. 옵션 2: 직접 Python 실행
            2. 서버 시작
              1. 기술적 세부 사항
                1. 페이지네이션 시스템
                2. 캐싱 시스템
              2. 제한 사항
                1. 문제 해결
                  1. 특허

                    Related MCP Servers

                    View all related MCP servers

                    Appeared in Searches

                    New 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/uzaysozen/imdb-mcp-server'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server