项目简介

TMDB Server MCP 是一个基于 Model Context Protocol (MCP) 构建的服务器，它集成 The Movie Database (TMDB) API，为 LLM 应用提供丰富的电影数据访问能力。通过此服务器，LLM 可以查询电影信息、获取电影推荐、了解趋势电影等，从而在对话中提供更专业的电影相关知识和功能。

主要功能点

工具 (Tools):
- 'search_movies': 根据电影标题或关键词搜索电影。
- 'get_recommendations': 基于指定的电影 ID 获取电影推荐。
- 'get_trending': 获取指定时间窗口（日/周）的趋势电影。
资源 (Resources):
- 提供对 TMDB 电影资源的访问，可以通过 'tmdb:///movie/<movie_id>' 格式的 URI 获取详细电影信息，包括标题、发布日期、评分、剧情概述、海报、演员、导演和影评等。

安装步骤

获取 TMDB API 密钥:
- 访问 TMDB 官网注册账号。
- 在账号设置中找到 API 选项，申请 API 密钥（用于开发者用途）。

克隆仓库并安装依赖:

git clone https://github.com/Laksh-star/mcp-server-tmdb
cd mcp-server-tmdb
npm install

构建服务器:
```
npm run build
```
设置环境变量:
- 设置 'TMDB_API_KEY' 环境变量为你在 TMDB 官网获取的 API 密钥。
```
export TMDB_API_KEY=YOUR_TMDB_API_KEY
```
注意: 请将 'YOUR_TMDB_API_KEY' 替换为你的实际 API 密钥。

服务器配置

要将 TMDB Server MCP 集成到 MCP 客户端（例如 Claude Desktop），需要在客户端的服务器配置文件中添加以下配置信息。

假设你的项目路径为 '/path/to/mcp-server-tmdb'，则配置应如下所示 (请根据实际安装路径调整):

{
  "mcpServers": {
    "tmdb": {
      "command": "/path/to/mcp-server-tmdb/dist/index.js",  //  指向编译后的服务器入口文件
      "env": {
        "TMDB_API_KEY": "YOUR_TMDB_API_KEY"  //  确保这里也替换为你的 TMDB API 密钥
      }
    }
  }
}

配置参数说明:

'"tmdb"': 服务器名称，可以自定义，用于在客户端中标识和调用此服务器。
'"command"': 服务器启动命令，指向 'dist/index.js' 文件，这是项目编译后的 JavaScript 入口文件。请务必替换 '/path/to/mcp-server-tmdb' 为你的实际项目路径。
'"env"': 环境变量配置，用于传递服务器运行所需的 'TMDB_API_KEY'。请务必替换 '"YOUR_TMDB_API_KEY"' 为你的实际 API 密钥。

Claude Desktop 客户端配置位置: 通常位于 '~/Library/Application Support/Claude/config.json' (macOS)。

基本使用方法

成功配置并启动 TMDB Server MCP 后，在 MCP 客户端中，你可以通过自然语言指令来调用其提供的工具和访问资源。例如，在 Claude Desktop 中：

搜索电影:

搜索关于人工智能的电影

获取趋势电影:

今天有哪些趋势电影？
这周的趋势电影有哪些？

获取电影推荐:

基于电影 ID 550 推荐电影

获取电影详情:

告诉我电影 ID 为 550 的电影信息

客户端会将这些指令转换为对 MCP 服务器的工具调用或资源请求，并返回相应的结果。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息