项目简介

本项目 'mcp-server-node-tmdb' 是一个基于 Model Context Protocol (MCP) 构建的服务器实现，它作为一个桥梁，允许大型语言模型 (LLM) 客户端通过标准化的 MCP 协议访问 The Movie Database (TMDB) API 提供的丰富的电影、电视节目和人物数据。该服务器提供了一系列工具，使 LLM 能够搜索电影、电视节目、人物，并获取电影推荐和趋势内容，从而增强 LLM 在媒体信息检索和推荐方面的能力。

主要功能点

资源发现与访问: 服务器声明了“热门电影”和“热门电视剧”等资源，客户端可以请求读取这些资源，获取JSON格式的流行媒体列表。同时，服务器还支持通过URI模板访问特定ID的电影、电视节目或人物的详细信息。
工具注册与调用: 服务器注册了多个实用工具，包括：
- 'search_movies': 按标题搜索电影。
- 'search_tv': 按标题搜索电视剧。
- 'search_people': 按姓名搜索人物。
- 'get_movie_recommendations': 根据电影ID获取电影推荐。
- 'get_trending': 获取热门电影、电视剧或人物。这些工具允许 LLM 客户端调用以执行特定的媒体信息查询任务。

安装步骤

克隆仓库: 首先，你需要克隆 'mcp-projects' 仓库到本地：

git clone https://github.com/burrsutter/mcp-projects
cd mcp-projects/mcp-server-node-tmdb

安装依赖: 使用 npm 安装项目依赖：
```
npm install
```
配置 TMDB API 密钥:
- 前往 TMDB 官网注册并获取 API 密钥。
- 在 'mcp-server-node-tmdb' 目录下创建 '.env' 文件。
- 在 '.env' 文件中添加以下内容，将 'YOUR_TMDB_API_KEY' 替换为你获取的 API 密钥：
```
TMDB_API_KEY=YOUR_TMDB_API_KEY
```
启动服务器: 运行以下命令启动 MCP 服务器：
```
npm start
```
服务器成功启动后，会在控制台输出 'TMDB MCP server running on stdio'。

服务器配置

要使 MCP 客户端连接到 'TMDB媒体信息MCP服务器'，你需要配置客户端的服务器连接参数。以下是基于 Stdio 传输协议的 JSON 格式配置信息，适用于如 'mcp-client-python-llm' 等 MCP 客户端：

{
  "serverName": "tmdb-server",
  "command": "node",
  "args": ["index.js"]
}

参数注释:

'serverName': 服务器的名称，用于客户端识别和管理连接。这里设置为 "tmdb-server"。
'command': 启动服务器进程的命令。对于 Node.js 服务器，通常设置为 "node"。
'args': 传递给启动命令的参数列表。这里指定运行 'index.js' 文件，即服务器的主程序入口。

请将以上配置信息填入你的 MCP 客户端配置中，以建立与 'TMDB媒体信息MCP服务器' 的连接。

基本使用方法

启动 MCP 客户端: 配置好服务器连接参数后，启动你的 MCP 客户端，例如 'mcp-client-python-llm'。
与 LLM 交互: 在 MCP 客户端中，你可以向 LLM 提出关于电影、电视节目或人物的查询。客户端会自动将请求转发给 'TMDB媒体信息MCP服务器'，调用相应的工具或资源。

示例查询:
- "请搜索最近流行的电影" (客户端可能会调用 'read_resource' 请求 'tmdb://movie/popular' 资源)
- "我想看一部科幻电影，你能推荐一些吗？" (客户端可能会调用 'search_movies' 工具搜索科幻电影，或调用 'get_movie_recommendations' 工具获取推荐)
- "谁演了《盗梦空间》？" (客户端可能会调用 'search_movies' 工具找到《盗梦空间》，然后读取电影详情资源，或者调用其他工具搜索演员信息)
LLM 将利用 'TMDB媒体信息MCP服务器' 提供的工具和数据来回答你的问题或满足你的需求。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息