使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器，它连接到 The Movie Database (TMDB) API，为LLM客户端（如 Claude Desktop）提供丰富的电影信息服务。通过此服务器，LLM可以搜索电影、获取电影推荐以及查询当前流行的电影。

主要功能点

电影搜索 (search_movies): 允许用户通过关键词或标题搜索电影，返回包含电影标题、发行年份、评分和简介的电影列表。
电影推荐 (get_recommendations): 基于指定的电影ID，为用户推荐相似的电影，返回推荐电影的详细信息。
流行电影查询 (get_trending): 查询每日或每周的流行电影，返回流行电影的列表及其详细信息。
电影资源访问 (tmdb:///movie/<movie_id>): 提供访问特定电影详细信息的功能，包括标题、发行日期、评分、简介、海报、演员、导演和影评等。

安装步骤

获取 TMDB API 密钥:
- 访问 TMDB 官网注册账号。
- 登录后，进入账号设置，找到 API 选项。
- 申请一个 API 密钥（用于个人开发用途）。

克隆仓库并安装依赖:

git clone https://github.com/MCP-Mirror/Laksh-star_mcp-server-tmdb
cd Laksh-star_mcp-server-tmdb
npm install

构建服务器:
```
npm run build
```
设置环境变量: 在你的终端中设置 'TMDB_API_KEY' 环境变量，将 'your_api_key_here' 替换为你从 TMDB 获取的 API 密钥。
```
export TMDB_API_KEY=your_api_key_here
```
或者，你也可以将此命令添加到你的 shell 配置文件（例如 '.bashrc' 或 '.zshrc'）中，以便永久设置。

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，你需要在客户端的服务器配置文件中添加以下配置信息。

对于 Claude Desktop，配置文件通常位于 '~/Library/Application Support/Claude/config.json'。将以下 JSON 代码添加到 'mcpServers' 字段中。

{
  "mcpServers": {
    "tmdb": {
      "command": "/path/to/Laksh-star_mcp-server-tmdb/dist/index.js",
      //  请将 "/path/to/Laksh-star_mcp-server-tmdb" 替换为你的本地仓库路径
      "env": {
        "TMDB_API_KEY": "your_api_key_here"
        //  请将 "your_api_key_here" 替换为你从 TMDB 获取的 API 密钥，
        //  但如果你已经在系统环境变量中设置了 TMDB_API_KEY，这里可以省略
      }
    }
  }
}

注意:

请务必将 'command' 字段中的 '/path/to/Laksh-star_mcp-server-tmdb' 替换为 你实际的仓库路径。
如果你已经在系统环境变量中设置了 'TMDB_API_KEY'，'env' 字段可以省略，或者只保留 'env: {}'。但为了配置的完整性，建议在此处也配置上，方便管理。

基本使用方法

完成配置后，启动 Claude Desktop 或其他 MCP 客户端，即可通过自然语言指令调用此 MCP 服务器的功能。以下是一些示例指令：

搜索电影:

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

查询今日流行电影:

"今天有哪些流行电影？"

查询本周流行电影:

"本周流行电影有哪些？"

获取电影推荐 (基于电影ID 550 - 《搏击俱乐部》):

"基于电影ID 550 给我推荐一些电影"

获取电影详情 (电影ID 550 - 《搏击俱乐部》):

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

客户端会解析这些指令，并调用 MCP 服务器的相应工具或资源来获取电影信息，并将结果返回给你。

关键词