TMDB MCP 服务器
该 MCP 服务器与电影数据库 (TMDB) API 集成，以提供电影信息、搜索功能和推荐。
先决条件
在安装和运行 TMDB MCP 服务器之前，请确保已安装和配置以下先决条件：
所需软件
Node.js
版本 18.0.0 或更高版本
从Node.js 官方网站下载
验证安装：
node --version
npm（Node 包管理器）
版本 8.0.0 或更高版本（附带 Node.js）
验证安装：
npm --version
TypeScript
将作为项目依赖项安装
可以全局安装：
npm install -g typescript验证安装：
tsc --version
Related MCP server: TMDB MCP Server
所需帐户和 API 密钥
TMDB账户
TMDB免费帐户
来自 TMDB 仪表板的 API 密钥
API 访问必须经过 TMDB 批准
Claude 桌面应用程序
已安装最新版本
访问修改配置文件
系统要求
操作系统
macOS（10.15 或更高版本）
Linux（现代发行版）
硬件要求
最低 4GB RAM
1GB可用磁盘空间
稳定的网络连接
开发环境
为了获得最佳开发体验，我们建议：
支持 TypeScript 的代码编辑器（例如 VS Code）
终端访问
Git（用于版本控制）
特征
工具
搜索电影
按标题或关键字搜索电影
输入：
query（字符串）：搜索查询返回：包含标题、上映年份、ID、评分和概述的电影列表
示例：搜索有关太空探索的电影
获取建议
根据电影ID获取电影推荐
输入：
movieId（字符串）：TMDB电影ID返回：推荐的 5 部电影及详情
示例：根据电影 ID 550（搏击俱乐部）获取推荐
获取趋势
获取指定时间段内的热门电影
输入：
timeWindow（字符串）：可以是“day”或“week”回归：十大热门电影及详情
示例：获取今日热门电影
资源
服务器提供对TMDB电影信息的访问：
电影（
tmdb:///movie/<movie_id>）全面的电影详情包括：
标题和发布日期
评分和概述
类型
海报网址
演员信息（前5名演员）
导演
精选评论
所有数据均以 JSON 格式返回
入门
获取 TMDB API 密钥：
在TMDB注册
前往您的帐户设置
导航至 API 部分
请求开发人员使用的 API 密钥
克隆并设置项目：
git clone [repository-url] cd mcp-server-tmdb npm install构建服务器：
npm run build设置环境变量：
export TMDB_API_KEY=your_api_key_here
与 Claude Desktop 一起使用
要将此服务器与 Claude Desktop 集成，请将以下内容添加到应用程序的服务器配置文件（位于~/Library/Application Support/Claude/config.json ）中：
将/full/path/to替换为项目目录的实际路径。
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 TMDB 服务器：
示例用法
一旦服务器通过 Claude Desktop 运行，您就可以使用以下命令：
搜索电影：
"Search for movies about artificial intelligence"获取热门电影：
"What are the trending movies today?" "Show me this week's trending movies"获取电影推荐：
"Get movie recommendations based on movie ID 550"获取电影详细信息：
"Tell me about the movie with ID 550"
错误处理
该服务器包括针对以下方面的全面错误处理：
无效的 API 密钥
网络错误
电影 ID 无效
格式错误的请求
错误消息将通过 Claude Desktop 以用户友好的格式返回。
发展
观察开发过程中的变化：
执照
此 MCP 服务器采用 MIT 许可证。详情请参阅许可证文件。
贡献
欢迎贡献代码！欢迎提交 Pull 请求。