MCP服务器-tmdb

Name: MCP服务器-tmdb
Author: Laksh-star

作者：Laksh-star54 星标更新：2025-09-13

安装使用来源：spider==github.com

项目介绍

【技术文档摘要】：

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

开发环境

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

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

功能

工具

search_movies
- 根据标题或关键词搜索电影
- 输入：query (字符串)：搜索查询
- 返回：带有标题、上映年份、ID、评分和概述的电影列表
- 示例：搜索关于太空探索的电影
get_recommendations
- 根据电影 ID 获取电影推荐
- 输入：movieId (字符串)：TMDB 电影 ID
- 返回：带有详细信息的前 5 部推荐电影
- 示例：根据电影 ID 550（《搏击俱乐部》）获取推荐
get_trending
- 获取指定时间窗口内的热门电影
- 输入：timeWindow (字符串)：要么是 "day" 要么是 "week"
- 返回：带有详细信息的前 10 部热门电影
- 示例：获取今天的热门电影

资源

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

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

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

用实际的项目目录路径替换 /full/path/to。

通过 Smithery 安装

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

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

示例用法

一旦服务器与 Claude Desktop 一起运行，您可以使用如下命令：

搜索电影：
```
"搜索关于人工智能的电影"
```

获取热门电影：

"今天有哪些热门电影？"
"显示本周的热门电影"

获取电影推荐：

"基于电影 ID 550 获取电影推荐"

获取电影详情：

"告诉我关于电影 ID 550 的信息"

错误处理

服务器包括全面的错误处理：

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

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

开发

在开发过程中监视更改：

npm run watch

许可证

此 MCP 服务器采用 MIT 许可证。详情见 LICENSE 文件。

贡献

欢迎贡献！请随时提交拉取请求。