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 服務器。