IMDb MCP 服务器 🎬

一个功能强大的 Model Context Protocol (MCP) 服务器，用于搜索、发现和播放 IMDb 上的内容。该服务器基于 FastMCP 构建，在 LLM 与电影元数据之间架起了一座稳固的桥梁，并配备了自定义播放层和现代化的 Web 仪表板。

✨ 功能特性

• 🚀 FastMCP 引擎：基于可流式传输 HTTP 的高性能 MCP 实现。

• 🔍 智能搜索：使用 IMDb 自动补全 API 的修补搜索逻辑，实现可靠、无需身份验证的标题发现。

• 📺 播放层：与 playimdb.com 直接集成，提供即时流媒体链接。

• 📊 监控仪表板：受密码保护的 WebUI，可实时监控指标、工具和健康状况。

• 🐳 Docker 就绪：优化的多阶段 Dockerfile，便于部署。

• 🤖 GitHub Actions：自动化的 CI/CD 工作流，可在发布标签时构建并将镜像推送到 GHCR。

🛠️ 包含的工具

🚀 快速开始

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 Cookie。如需访问私有列表，您可以扩展 src/tools/index.ts 中的 imdbClient 会话。

• 播放：播放 URL 指向第三方提供商；请负责任地使用。

使用 FastMCP 和 TypeScript 倾心打造。