使用说明

项目简介

本项目 'imdb-mcp-server' 是一个实现了 Model Context Protocol (MCP) 的服务器，专注于提供电影和电视节目相关的信息查询功能。它利用 RapidAPI 提供的 IMDb API 接口，将 IMDb 庞大的影视数据转化为可以通过 MCP 协议访问的 资源 (Resources) 和 工具 (Tools)，使得 LLM 客户端能够方便地获取电影、电视节目的详细信息、演员阵容、排行榜单等数据，从而增强 LLM 在影视领域的知识和应用能力。

主要功能点

强大的搜索工具: 提供多种搜索条件，例如根据电影标题、类型、演员、评分等快速查找电影和电视节目。
详尽的影视信息: 可以获取电影或电视节目的详细信息，包括剧情简介、演职人员、用户评分等。
丰富的排行榜单: 提供 IMDb Top 250 电影/电视剧榜单、最受欢迎电影/电视剧榜单、美国票房榜单等。
及时的上映信息: 支持查询即将上映的电影和电视节目，并可按国家/地区筛选。
全面的配置信息: 允许获取所有可用的电影/电视节目类型、国家/地区、语言和流派等配置信息，方便用户进行更精确的搜索。
印度电影专区: 特别提供针对印度电影的特色榜单和趋势信息，例如 Top 50 马拉雅拉姆语/泰米尔语/泰卢固语电影、最受期待的印度电影等。
高效的缓存机制: 内置缓存系统，减少对 IMDb API 的重复请求，提高响应速度并节省 API 调用次数。
分页返回结果: 所有列表类工具均采用分页设计，每次返回少量结果（5条），更适合 LLM 处理和理解。

安装步骤

推荐方式：使用 Docker (简化部署)

克隆仓库:

git clone https://github.com/uzaysozen/imdb-mcp-server.git
cd imdb-mcp-server

安装 Python 依赖: （如果选择 Docker 方式，可以跳过此步骤，Docker 镜像中已包含）
```
pip install -r requirements.txt
```
获取 IMDb API Key:
- 访问 RapidAPI 并注册账号。
- 订阅 IMDb API。
- 在 RapidAPI 控制台中找到您的 API Key。
设置 API Key 环境变量:
- Docker 方式: 在运行 Docker 容器时，通过 '-e RAPID_API_KEY_IMDB=your_api_key_here' 参数设置。
- 直接 Python 运行: 在终端中执行 'export RAPID_API_KEY_IMDB=your_api_key_here' (Linux/macOS) 或在系统环境变量中设置 'RAPID_API_KEY_IMDB' (Windows)。

构建 Docker 镜像 (Docker 方式):

docker build -t imdb_server .

运行 Docker 容器 (Docker 方式):

docker run -d -p 8000:8000 -e RAPID_API_KEY_IMDB=your_api_key_here --name imdb_server imdb_server

直接运行 Python 脚本 (非 Docker 方式):

python imdb_server.py

服务器配置

要将 'imdb-mcp-server' 集成到 MCP 客户端（例如 Claude Desktop），您需要在客户端的配置文件中添加以下服务器配置信息。以 'claude_desktop_config.json' 为例：

{
  "mcpServers": {
    "imdb_server": {  // 服务器名称，可以自定义
      "command": "docker", // 启动服务器的命令，Docker 方式使用 "docker"，直接 Python 运行方式使用 Python 解释器路径
      "args": [ // 命令参数
        "exec",      // Docker 命令参数，表示在运行中的容器中执行命令 (Docker 方式)
        "-i",        // Docker 命令参数，表示保持 STDIN 开放 (Docker 方式)
        "imdb_server", // Docker 容器名称，与运行 Docker 容器时 '--name' 参数一致 (Docker 方式)
        "imdb-mcp-server" //  服务器启动脚本名称 (Docker 方式)； 直接 Python 运行方式则为服务器脚本的路径，例如 "/path/to/imdb_server.py"
      ],
      "env": { // 环境变量
        "RAPID_API_KEY_IMDB": "your_api_key_here" // IMDb API Key，请替换为您的实际 API Key
      }
    }
  }
}

注意:

Docker 方式: 'command' 设置为 '"docker"'， 'args' 中指定 Docker 相关参数，'"imdb_server"' 需要替换为您运行 Docker 容器时指定的 '--name' 值。
直接 Python 运行方式: 'command' 设置为 Python 解释器路径 (例如 '"/usr/bin/python3"' 或 '"python"')， 'args' 设置为服务器脚本的路径 (例如 '"/path/to/imdb_server.py"' )。请根据您的 Python 安装路径进行调整。
'"your_api_key_here"' 必须替换为您在 RapidAPI 获取的实际 API Key。

基本使用方法

配置完成后，在 MCP 客户端中，您可以通过以下工具名称调用 'imdb_server' 提供的功能：

搜索工具:
- 'search_imdb': 通用电影/电视节目搜索
IMDb ID 工具:
- 'get_imdb_details': 获取详细信息
- 'get_directors': 获取导演
- 'get_cast': 获取演员
- 'get_writers': 获取编剧
配置工具:
- 'get_types': 获取所有内容类型
- 'get_genres': 获取所有流派
- 'get_countries': 获取所有国家/地区
- 'get_languages': 获取所有语言
电影工具:
- 'get_top_250_movies': IMDb Top 250 电影
- 'get_top_box_office_us': 美国票房榜
- 'get_most_popular_movies': 最受欢迎电影
电视剧工具:
- 'get_top_250_tv_shows': IMDb Top 250 电视剧
- 'get_most_popular_tv_shows': 最受欢迎电视剧
即将上映工具:
- 'get_upcoming_releases': 即将上映影片 (按国家/地区和类型)
- 'get_available_country_codes_for_upcoming_releases': 即将上映影片支持的国家/地区代码
印度电影专区工具:
- 'get_top_rated_malayalam_movies': Top 50 马拉雅拉姆语电影
- 'get_upcoming_indian_movies': 最受期待印度电影
- 'get_trending_tamil_movies': 热门泰米尔语电影
- 'get_trending_telugu_movies': 热门泰卢固语电影
- 'get_top_rated_tamil_movies': Top 50 泰米尔语电影
- 'get_top_rated_telugu_movies': Top 50 泰卢固语电影
- 'get_top_rated_indian_movies': Top 250 印度电影

示例：

在与 LLM 的对话中，您可以指示 LLM 使用 'search_imdb' 工具来搜索电影，例如：

'请使用 search_imdb 工具搜索电影 "Inception"。'

LLM 即可调用 'search_imdb' 工具并返回《盗梦空间》的搜索结果。您可以使用其他工具来获取更详细的信息或浏览各种榜单。

关键词