IMDb MCPサーバー 🎬

IMDbのコンテンツを検索、発見、再生するための強力なModel Context Protocol (MCP) サーバーです。FastMCPで構築されたこのサーバーは、LLMと映画メタデータの間の堅牢なブリッジを提供し、カスタム再生レイヤーとモダンなWebダッシュボードを備えています。

✨ 特徴

• 🚀 FastMCPエンジン: ストリーミング可能なHTTP上での高性能なMCP実装。

• 🔍 インテリジェント検索: 信頼性の高い認証不要のタイトル発見のために、IMDbオートコンプリートAPIを使用したパッチ適用済みの検索ロジック。

• 📺 再生レイヤー: 即時ストリーミングリンクのためのplayimdb.comとの直接統合。

• 📊 監視ダッシュボード: メトリクス、ツール、ヘルスをリアルタイムで監視するためのパスワード保護されたWebUI。

• 🐳 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へのカスタムフォールバックを使用しています。

• 認証: ほとんどのツールはステートレスであり、IMDbのクッキーを必要としません。プライベートリストへのアクセスについては、src/tools/index.ts内のimdbClientセッションを拡張してください。

• 再生: 再生URLはサードパーティのプロバイダーを指しています。責任を持って使用してください。

FastMCPとTypeScriptを使用して❤️を込めて構築されました。