imdb-mcp-server

🚀 IMDb MCP 服务器使用指南

本指南将详细介绍如何安装、配置和使用 IMDb MCP 服务器，帮助你轻松获取 IMDb 数据。

🚀 快速开始

安装依赖

在使用服务器前，需要安装必要的依赖：

pip install requests mcp

📦 安装指南

1. 使用 MCP CLI 运行服务器

你可以选择以下方式运行服务器：

# 直接运行
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

2. 配置环境变量

在终端中设置以下环境变量：

# 设置 IMDb API 密钥
export RAPID_API_KEY_IMDB=your_api_key_here

# 如果使用 Docker，可以在启动容器时通过参数传递
docker run -d -p 8000:8000 -e RAPID_API_KEY_IMDB=your_api_key_here --name imdb_server imdb_server

3. 配置 claude_desktop_config.json

将以下配置添加到你的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "imdb_server": {
      "command": "/path/to/your/python",
      "args": [
        "/path/to/imdb_server.py"
      ],
      "env": {
        "RAPID_API_KEY_IMDB": "your_api_key_here"
      }
    }
  }
}

💻 使用示例

1. 数据检索工具

所有数据检索工具均支持分页功能，每次最多返回 5 项结果。

基础用法

# 获取前 5 位
get_top_250_movies()

# 获取第 6 到 10 位
get_top_250_movies(start=5)

2. 分页系统

请求示例

get_top_250_movies(start=5) # 返回第 6-10 项

响应示例

{
  "movies": [
    {
      "id": "tt0012345",
      "title": "电影名称",
      "year": 2023,
      "rating": 9.5,
      "description": "电影简介"
    },
    ...
  ],
  "metadata": {
    "totalCount": 250,
    "hasMore": true,
    "nextStart": 10
  }
}

示例代码

from imdb_mcp import IMDBClient

client = IMDBClient('your_api_key_here')
movies = client.get_top_250_movies(start=0)
print(movies)

🔧 技术细节

实现框架

• IMDb API：通过 RapidAPI 调用
• MCP：用于 API 接口
• Requests：用于 API 通信
• FastMCP：服务器实现框架
• 自定义缓存系统：内存缓存
• 分页系统：限制每次返回结果为 5 项

缓存机制

• 默认缓存配置：

response_cache = ResponseCache(expiry_seconds=120, max_size=50)

• 功能特点：
  • 内存中缓存响应
  • 设置过期时间（默认：10 分钟）
  • 最大缓存大小（默认：100 个键）
  • 定期清理过期条目

⚠️ 注意事项

⚠️ 重要提示

• API 调用次数受 RapidAPI 套餐限制
• 部分详细信息需要单独请求
• 分页功能需手动实现
• 缓存机制可提高性能，但需处理缓存失效情况

通过以上步骤，您可以成功配置并使用 IMDb MCP 服务器。