IMDb MCP 서버 🎬

IMDb의 콘텐츠를 검색, 탐색 및 재생하기 위한 강력한 모델 컨텍스트 프로토콜(MCP) 서버입니다. FastMCP로 구축된 이 서버는 LLM과 영화 메타데이터 간의 강력한 가교 역할을 하며, 사용자 지정 재생 레이어와 현대적인 웹 대시보드를 제공합니다.

✨ 주요 기능

• 🚀 FastMCP 엔진: 스트리밍 가능한 HTTP 기반의 고성능 MCP 구현.

• 🔍 지능형 검색: 신뢰할 수 있고 인증이 필요 없는 타이틀 검색을 위해 IMDb 자동 완성 API를 사용하는 패치된 검색 로직.

• 📺 재생 레이어: 즉각적인 스트리밍 링크를 위한 playimdb.com 직접 통합.

• 📊 모니터링 대시보드: 실시간으로 메트릭, 도구 및 상태를 모니터링할 수 있는 비밀번호 보호 웹 UI.

• 🐳 Docker 지원: 간편한 배포를 위해 최적화된 다단계 Dockerfile.

• 🤖 GitHub Actions: 릴리스 태그 시 이미지를 빌드하고 GHCR로 푸시하는 자동화된 CI/CD 워크플로우.

🛠️ 포함된 도구

🚀 빠른 시작

1. 의존성 설치

npm install

2. 환경 설정

cp .env.example .env

.env 파일을 편집하여 WEBUI_PASSWORD를 설정하세요.

3. 개발 서버 실행

npm run dev

🌐 엔드포인트

• MCP 엔드포인트: http://127.0.0.1:8080/mcp

• 대시보드: http://127.0.0.1:8080/dashboard

• 상태 확인: http://127.0.0.1:8080/health

🐳 Docker 배포

로컬에서 이미지 빌드:

docker build -t imdb-mcp .

컨테이너 실행:

docker run --rm \
  -p 8080:8080 \
  -e HOST=0.0.0.0 \
  -e PORT=8080 \
  -e WEBUI_PASSWORD=your-secure-password \
  -e WEBUI_SESSION_SECRET=your-secret \
  imdb-mcp

Docker Compose

또는 Docker Compose를 사용하여 컨테이너를 관리하세요:

docker-compose up -d

docker-compose.yml 예시:

services:
  imdb-mcp:
    image: ghcr.io/danish-mar/imdb-mcp:latest
    ports:
      - "8080:8080"
    environment:
      - WEBUI_PASSWORD=your-password

📁 프로젝트 구조

src/
  index.ts       # Entry point & Server initialization
  config.ts      # App configuration & Env loading
  server.ts      # FastMCP instance setup
  tools/         # IMDb tool implementations (Search, Playback, etc.)
  webui/         # Hono routes for the dashboard
  lib/           # Auth & formatting utilities
views/           # EJS templates for the WebUI
.github/         # GitHub Actions workflows for Docker publishing

📝 참고 사항

• 검색 패치: 표준 imdb-core GraphQL 해시가 현재 오래되었기 때문에 이 서버는 IMDb 자동 완성 API에 대한 사용자 지정 폴백을 사용합니다.

• 인증: 대부분의 도구는 상태 비저장(stateless)이며 IMDb 쿠키가 필요하지 않습니다. 비공개 목록에 액세스하려면 src/tools/index.ts에서 imdbClient 세션을 확장할 수 있습니다.

• 재생: 재생 URL은 타사 제공업체를 가리키므로 책임감 있게 사용하십시오.

FastMCP와 TypeScript를 사용하여 ❤️로 제작되었습니다.