IMDb MCP Server

基本能力

产品定位

IMDb MCP Server 是一个专门用于访问 IMDb 数据的服务，为 AI 代理提供电影和电视节目的详细信息。

核心功能

• 🎬 电影和电视节目搜索功能
• 📋 电影和电视节目的详细信息
• 👨‍👩‍👧‍👦 演员和工作人员信息
• 🏆 高分和热门内容列表
• 💰 票房数据
• 🌍 特定国家的电影信息（特别关注印度电影）
• 🔜 即将上映的内容
• 🔄 高效的响应缓存系统

适用场景

• 电影和电视节目信息查询
• 演员和导演作品检索
• 票房和热门内容分析
• 特定地区电影信息查询
• 即将上映内容预告

工具列表

1. Search Tools: 搜索电影和电视节目
2. IMDb ID Tools: 根据 IMDb ID 获取详细信息
3. Configuration Tools: 获取可用内容类型、类型、国家和语言
4. Movies Tools: 获取高分电影、票房记录和热门电影
5. TV Shows Tools: 获取高分和热门电视节目
6. Upcoming Releases Tools: 获取即将上映的电影和电视节目
7. India Spotlight Tools: 获取印度特定电影信息

常见问题解答

• API key 不被识别：确保 RAPID_API_KEY_IMDB 环境变量正确设置
• 速率限制超出：检查 RapidAPI 订阅级别和限制
• 超时错误：服务器有30秒超时，尝试限制参数
• 空结果：尝试更广泛的搜索词或检查 IMDb 数据库中是否存在该内容
• 高内存使用：如果长时间运行，偶尔重启服务器以清除缓存

使用教程

使用依赖

1. 创建 RapidAPI 账户
2. 订阅 IMDb API
3. 设置环境变量： RAPID_API_KEY_IMDB=your_api_key_here

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @uzaysozen/imdb-mcp-server --client claude

使用 Docker 安装

1. 克隆仓库

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

1. 安装依赖

pip install -r requirements.txt

1. 构建 Docker 镜像

docker build -t imdb_server .

1. 运行 Docker 容器

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

直接 Python 执行

1. 克隆仓库

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

1. 安装依赖

pip install -r requirements.txt

1. 设置 API key 环境变量

export RAPID_API_KEY_IMDB=your_api_key_here

调试方式

# 直接启动服务器
python imdb_server.py

# 使用 MCP CLI
mcp run imdb_server.py

# 使用 Docker 时，服务器随容器自动启动
docker run -d -p 8000:8000 -e RAPID_API_KEY_IMDB=your_api_key_here --name imdb_server imdb_server

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。