🚀 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 服务器。