IMDB MCP Server
IMDB MCP Server
一个可在云端运行的 JSON-RPC 服务,提供对 IMDB 数据的访问。专为通过 MCP(Model Context Protocol)与 LLM 协同工作而设计。
工作原理
LLM 配置:将 MCP 服务器 URL 添加到你的 LLM 配置中
发现:LLM 查询服务器 URL 以了解可用工具
查询:LLM 发送 JSON-RPC 请求以获取 IMDB 数据
响应:服务器返回结构化数据,由 LLM 解读并向用户解释
Related MCP server: moviefinder-mcp
端点
端点 | 方法 | 说明 |
| GET | HTML 文档(人类可读) |
| GET | 服务信息(JSON) |
| POST | JSON-RPC 2.0 端点 |
| POST | 用于 LLM 工具调用的 MCP 协议端点 |
| GET | 云端部署的健康检查 |
可用工具
工具 | 说明 | 参数 |
| 按电影标题搜索 |
|
| 获取完整电影信息 |
|
| 搜索演员/导演 |
|
| 获取人物信息/电影作品列表 |
|
| 获取 IMDB Top 250 |
|
| 获取电影演员阵容 |
|
JSON-RPC 用法
向 /jsonrpc 发送 POST 请求:
{
"jsonrpc": "2.0",
"method": "search_movies",
"params": {"query": "The Matrix", "limit": 5},
"id": 1
}响应:
{
"jsonrpc": "2.0",
"result": [
{"id": "0133093", "title": "The Matrix", "year": 1999},
{"id": "0234215", "title": "The Matrix Reloaded", "year": 2003}
],
"id": 1
}LLM MCP 配置
将其添加到你的 LLM 的 MCP 服务器配置中:
{
"mcpServers": {
"imdb": {
"url": "https://your-deployed-url.com/mcp",
"transport": "http"
}
}
}本地开发
本地运行
pip install -r requirements.txt
python app.py服务器运行于 http://localhost:8080
使用 Docker 运行
docker build -t imdb-mcp .
docker run -p 8080:8080 imdb-mcp云端部署
Cloud Foundry
cf push使用 manifest.yaml 配置。
SAP BTP (Cloud Foundry)
# Build MTA archive
mbt build
# Deploy
cf deploy mta_archives/imdb-mcp-server_1.0.0.mtar使用 mta.yaml 配置。
Heroku
heroku create imdb-mcp-server
git push heroku main使用 Procfile 和 runtime.txt。
Docker(任意云)
# Build
docker build -t imdb-mcp .
# Run
docker run -p 8080:8080 imdb-mcp
# Push to registry
docker tag imdb-mcp your-registry/imdb-mcp:latest
docker push your-registry/imdb-mcp:latestGoogle Cloud Run
gcloud run deploy imdb-mcp \
--source . \
--platform managed \
--allow-unauthenticatedAWS App Runner / ECS
使用 Dockerfile 配合你偏好的 AWS 容器服务。
项目结构
imdb-mcp/
├── app.py # FastAPI JSON-RPC server
├── imdb_backend.py # Cinemagoer wrapper
├── server.py # FastMCP server (for local MCP)
├── requirements.txt # Python dependencies
├── pyproject.toml # Project metadata
├── Dockerfile # Container image
├── Procfile # Heroku/PaaS process file
├── runtime.txt # Python version
├── manifest.yaml # Cloud Foundry manifest
├── mta.yaml # SAP BTP MTA descriptor
├── .dockerignore # Docker ignore patterns
└── .cfignore # Cloud Foundry ignore patterns环境变量
变量 | 默认值 | 说明 |
| 8080 | 服务器端口 |
注意事项
Cinemagoer 通过网页抓取方式查询 IMDB,响应速度可能比基于 API 的解决方案慢
仅供非商业用途(根据 IMDB 服务条款)
无需 API 密钥
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
YouTube transcripts, search, channel browsing, and playlists for AI agents via MCP.
Search and inspect source-pinned agent skills, plugins and tools through a free public MCP.
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides access to IMDB movie and person data, including searches, cast details, and top-rated lists through the Model Context Protocol. It enables LLMs to fetch structured cinematic metadata and filmographies using the Cinemagoer backend.1-
- FlicenseAqualityDmaintenanceAn MCP server that wraps The Movie Database (TMDB) API, enabling search for movies and TV shows, retrieval of movie details, recommendations, similar movies, trending content, streaming providers, and movie discovery.8-
- AlicenseAqualityCmaintenanceMCP server for the OMDb API - search movies, series, and episodes from any MCP-compatible client.5MIT
- FlicenseNot gradedqualityDmaintenanceA robust MCP server that wraps The Movie Database API, enabling LLMs to search movies, get details, popular movies, and recommendations.-