TMDB MCP 服务器

此 MCP 服务器与 The Movie Database (TMDB) API 集成，以提供电影信息、搜索功能和推荐。

<a href="https://glama.ai/mcp/servers/g3nl1a0n25"><img width="380" height="200" src="https://glama.ai/mcp/servers/g3nl1a0n25/badge" alt="mcp-server-tmdb MCP server" /></a>

前提条件

在安装和运行 TMDB MCP 服务器之前，请确保已安装并配置以下前提条件：

必需软件

• Node.js

  • 18.0.0 或更高版本
  • 从 Node.js 官方网站 下载
  • 验证安装：node --version

• npm (Node Package Manager)

  • 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 内存
  • 1GB 可用磁盘空间
  • 稳定的互联网连接

开发环境

为了获得最佳开发体验，我们建议：

• 支持 TypeScript 的代码编辑器（例如 VS Code）
• 终端访问
• Git（用于版本控制）

功能

工具

• search_movies

  • 按标题或关键字搜索电影
  • 输入：query (string)：搜索查询
  • 返回：包含标题、发行年份、ID、评分和概述的电影列表
  • 示例：搜索关于太空探索的电影

• get_recommendations

  • 根据电影 ID 获取电影推荐
  • 输入：movieId (string)：TMDB 电影 ID
  • 返回：包含详细信息的前 5 部推荐电影
  • 示例：根据电影 ID 550（搏击俱乐部）获取推荐

• get_trending

  • 获取指定时间窗口内的热门电影
  • 输入：timeWindow (string)："day" 或 "week"
  • 返回：包含详细信息的前 10 部热门电影
  • 示例：获取今天的热门电影

资源

该服务器提供对 TMDB 电影信息的访问：

• 电影 (tmdb:///movie/<movie_id>)
  • 包含全面的电影详细信息，包括：
    • 标题和发行日期
    • 评分和概述
    • 类型
    • 海报 URL
    • 演员信息（前 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）：

{
  "mcpServers": {
    "tmdb": {
      "command": "/full/path/to/dist/index.js",
      "env": {
        "TMDB_API_KEY": "your_api_key_here"
      }
    }
  }
}

将 /full/path/to 替换为您的项目目录的实际路径。

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 TMDB 服务器：

npx -y @smithery/cli install @Laksh-star/mcp-server-tmdb --client claude

使用示例

一旦服务器与 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 以用户友好的格式返回。

开发

要在开发期间监视更改：

npm run watch

许可证

此 MCP 服务器在 MIT 许可证下获得许可。 有关详细信息，请参见 LICENSE 文件。

贡献

欢迎贡献！ 请随时提交 Pull Request。