Skip to main content
Glama
Adarsh2001-dot

IMDB MCP Server

IMDB MCP Server

클라우드에서 실행할 수 있는 JSON-RPC 서비스로, IMDB 데이터에 접근할 수 있게 해줍니다. MCP(모델 컨텍스트 프로토콜)를 통해 LLM과 원활하게 작동하도록 설계되었습니다.

작동 방식

  1. LLM 구성: MCP 서버 URL을 LLM의 구성에 추가합니다.

  2. 발견: LLM이 서버 URL을 조회하여 사용 가능한 도구를 파악합니다.

  3. 쿼리: LLM이 JSON-RPC 요청을 전송하여 IMDB 데이터를 가져옵니다.

  4. 응답: 서버가 구조화된 데이터를 반환하고, LLM이 이를 해석하여 사용자에게 설명합니다.

Related MCP server: IMDB MCP Server

엔드포인트

엔드포인트

메서드

설명

/

GET

HTML 문서(사람이 읽을 수 있는 형식)

/info

GET

서비스 정보(JSON)

/jsonrpc

POST

JSON-RPC 2.0 엔드포인트

/mcp

POST

LLM 도구 호출을 위한 MCP 프로토콜 엔드포인트

/health

GET

클라우드 배포를 위한 상태 확인

사용 가능한 도구

도구

설명

매개변수

search_movies

제목으로 영화 검색

query, limit

get_movie_details

전체 영화 정보 가져오기

movie_id

search_people

배우/감독 검색

query, limit

get_person_details

인물 정보/필모그래피 가져오기

person_id

get_top_250_movies

IMDB Top 250 가져오기

limit

get_movie_cast

영화의 출연진 가져오기

movie_id, limit

JSON-RPC 사용법

/jsonrpc 엔드포인트에 POST 요청을 전송합니다.

{
    "jsonrpc": "2.0",
    "method": "search_movies",
    "params": {"query": "The Matrix", "limit": 5},
    "id": 1
}

응답:

{
    "jsonrpc": "2.0",
    "result": [
        {"id": "0133093", "title": "The Matrix", "year": 1999},
        {"id": "0234215", "title": "The Matrix Reloaded", "year": 2003}
    ],
    "id": 1
}

LLM MCP 구성

LLM의 MCP 서버 구성에 추가합니다.

{
    "mcpServers": {
        "imdb": {
            "url": "https://your-deployed-url.com/mcp",
            "transport": "http"
        }
    }
}

로컬 개발

로컬에서 실행

pip install -r requirements.txt
python app.py

서버는 http://localhost:8080에서 실행됩니다.

Docker로 실행

docker build -t imdb-mcp .
docker run -p 8080:8080 imdb-mcp

클라우드 배포

Cloud Foundry

cf push

manifest.yaml 구성을 사용합니다.

SAP BTP (Cloud Foundry)

# Build MTA archive
mbt build

# Deploy
cf deploy mta_archives/imdb-mcp-server_1.0.0.mtar

mta.yaml 구성을 사용합니다.

Heroku

heroku create imdb-mcp-server
git push heroku main

Procfileruntime.txt를 사용합니다.

Docker (모든 클라우드)

# Build
docker build -t imdb-mcp .

# Run
docker run -p 8080:8080 imdb-mcp

# Push to registry
docker tag imdb-mcp your-registry/imdb-mcp:latest
docker push your-registry/imdb-mcp:latest

Google Cloud Run

gcloud run deploy imdb-mcp \
    --source . \
    --platform managed \
    --allow-unauthenticated

AWS App Runner / ECS

Dockerfile을 원하는 AWS 컨테이너 서비스와 함께 사용합니다.

프로젝트 구조

imdb-mcp/
├── app.py              # FastAPI JSON-RPC server
├── imdb_backend.py     # Cinemagoer wrapper
├── server.py           # FastMCP server (for local MCP)
├── requirements.txt    # Python dependencies
├── pyproject.toml      # Project metadata
├── Dockerfile          # Container image
├── Procfile            # Heroku/PaaS process file
├── runtime.txt         # Python version
├── manifest.yaml       # Cloud Foundry manifest
├── mta.yaml            # SAP BTP MTA descriptor
├── .dockerignore       # Docker ignore patterns
└── .cfignore           # Cloud Foundry ignore patterns

환경 변수

변수

기본값

설명

PORT

8080

서버 포트

참고 사항

  • Cinemagoer는 웹 스크래핑을 통해 IMDB를 조회하므로 API 기반 솔루션보다 응답이 느릴 수 있습니다.

  • 비상업적 용도로만 사용할 수 있습니다(IMDB 서비스 약관에 따름).

  • API 키가 필요 없습니다.

F
license - not found
Not graded
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to search and retrieve movie information from The Movie Database (TMDB) API through the Model Context Protocol interface.
    20
    2
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides access to IMDB movie and person data, including searches, cast details, and top-rated lists through the Model Context Protocol. It enables LLMs to fetch structured cinematic metadata and filmographies using the Cinemagoer backend.
    1
  • F
    license
    A
    quality
    D
    maintenance
    An MCP server that wraps The Movie Database (TMDB) API, enabling search for movies and TV shows, retrieval of movie details, recommendations, similar movies, trending content, streaming providers, and movie discovery.
    8
  • A
    license
    A
    quality
    C
    maintenance
    MCP server for the OMDb API - search movies, series, and episodes from any MCP-compatible client.
    5
    MIT

View all related MCP servers

Related MCP Connectors

  • MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.

  • Real-time Amazon, WIPO & PACER data for AI agents — 19 tools via the MCP protocol.

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

View all MCP Connectors

Latest Blog Posts

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/Adarsh2001-dot/imdb-mcp'

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