mcp-server-tmdb

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

所需帐户和 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 格式返回

入门

1. 获取 TMDB API 密钥：
   • 在TMDB注册
   • 前往您的帐户设置
   • 导航至 API 部分
   • 请求开发人员使用的 API 密钥
2. 克隆并设置项目：
   git clone [repository-url] cd mcp-server-tmdb npm install
3. 构建服务器：
   npm run build
4. 设置环境变量：
   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 运行，您就可以使用以下命令：

1. 搜索电影：
   "Search for movies about artificial intelligence"
2. 获取热门电影：
   "What are the trending movies today?" "Show me this week's trending movies"
3. 获取电影推荐：
   "Get movie recommendations based on movie ID 550"
4. 获取电影详细信息：
   "Tell me about the movie with ID 550"

错误处理

该服务器包括针对以下方面的全面错误处理：

• 无效的 API 密钥
• 网络错误
• 电影 ID 无效
• 格式错误的请求

错误消息将通过 Claude Desktop 以用户友好的格式返回。

发展

观察开发过程中的变化：

执照

此 MCP 服务器采用 MIT 许可证。详情请参阅许可证文件。

贡献

欢迎贡献代码！欢迎提交 Pull 请求。