使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 标准构建的服务器，旨在为 AI 助手等 MCP 客户端提供访问 The Movie Database (TMDB) 电影数据库 API 的能力。通过此服务器，AI 助手可以方便地搜索电影信息，例如电影名称、年份等，并获取详细的电影数据。

主要功能点

电影搜索: 支持通过电影标题、年份等关键词搜索电影。
电影信息检索: 能够获取电影的详细信息。
MCP 协议支持: 完全遵循 MCP 协议，易于与任何兼容 MCP 协议的 AI 助手集成。

安装步骤

克隆仓库

首先，将仓库克隆到本地：

git clone https://github.com/rakeshgangwar/tmdb-mcp-server.git
cd tmdb-mcp-server

安装依赖

确保你已安装 Node.js (>= 18)。然后安装项目依赖：
```
npm install
```
构建服务器

运行构建命令编译 TypeScript 代码：
```
npm run build
```
配置 TMDB API 密钥

你需要一个 TMDB API 密钥。访问 TMDB 官网注册并获取 API 密钥。

获取密钥后，不要修改任何代码，而是在配置 MCP 服务器时，将密钥配置在环境变量中。

服务器配置

为了让 MCP 客户端（如 AI 助手）连接到 'tmdb-mcp-server'，你需要在 MCP 客户端的配置文件（通常是 'cline_mcp_settings.json'）中添加或修改服务器配置。以下是一个配置示例，你需要根据你的实际路径和 API 密钥进行调整：

{
  "mcpServers": {
    "tmdb": {
      "command": "node",
      "args": ["/path/to/tmdb-mcp-server/dist/index.js"],
      "env": {
        "TMDB_API_KEY": "YOUR_TMDB_API_KEY"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

配置参数说明:

'"tmdb"': 服务器名称，可以自定义，用于在 MCP 客户端中引用。
'"command": "node"': 运行服务器的命令，这里使用 Node.js 解释器。
'"args": ["/path/to/tmdb-mcp-server/dist/index.js"]': 启动服务器的参数，指向构建后的 'index.js' 文件路径。 请将 '/path/to/tmdb-mcp-server' 替换为你的 'tmdb-mcp-server' 仓库在本地的实际路径。
'"env": { "TMDB_API_KEY": "YOUR_TMDB_API_KEY" }': 设置环境变量。 请将 '"YOUR_TMDB_API_KEY"' 替换为你从 TMDB 官网获取的 API 密钥。 非常重要：请勿将 API 密钥直接写入代码，而是通过环境变量传递。
'"disabled": false': 设置为 'false' 表示启用该服务器。
'"autoApprove": []': 自动允许的操作列表，默认为空。

请注意： MCP客户端会读取此配置文件，并根据 '"command"' 和 '"args"' 的配置来启动 'tmdb-mcp-server' 服务器进程。'tmdb-mcp-server' 服务器启动后，会通过标准输入输出 (stdio) 与 MCP 客户端进行通信，遵循 MCP 协议交换 JSON-RPC 消息。

基本使用方法

配置完成后，当 MCP 客户端需要搜索电影信息时，就可以调用 'tmdb' 服务器提供的 'search_movies' 工具。

工具名称: 'search_movies'

工具描述: 使用 The Movie Database API 搜索电影。

工具参数:

'query' (必填): 搜索关键词，例如电影名称。
'year' (可选): 上映年份，用于筛选特定年份的电影。
'page' (可选): 页码，用于获取搜索结果的特定页数，默认为第 1 页。

示例参数 (JSON 格式):

{
  "query": "Inception",
  "year": 2010
}

当 MCP 客户端调用 'search_movies' 工具并提供上述参数后，'tmdb-mcp-server' 会向 TMDB API 发送请求，并将返回的电影搜索结果以 JSON 格式返回给 MCP 客户端。客户端可以解析 JSON 结果并呈现给用户或进行后续处理。

关键词