关键词

电影数据TMDBAI助手电影搜索电影推荐电影评论

项目简介

TMDB 电影数据 MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为 AI 助手（如 Claude）提供便捷的电影数据访问能力。通过此服务器，AI 助手可以获取电影信息、搜索电影、生成电影推荐和影评，从而扩展其在电影领域的知识和服务能力。

主要功能点

  • 资源 (Resources)：

    • 'tmdb://info': 提供关于 TMDB API 的基本信息。
    • 'tmdb://trending': 获取当前热门电影列表。
    • 'tmdb://movie/{id}': （资源模板）根据电影 ID 获取特定电影的详细信息。

  • Prompt 模板 (Prompts)：

    • 'movie-review': 根据电影标题、评分和风格生成电影评论。
    • 'movie-recommendation': 根据用户指定的电影类型和心情推荐电影。

  • 工具 (Tools)：

    • 'search-movies': 根据电影标题或关键词搜索电影。
    • 'get-trending': 获取每日或每周热门电影。
    • 'get-similar': 查找与指定电影相似的电影。
    • 'get-movie-details': 获取指定电影的详细信息。

安装步骤

  1. 克隆仓库

    git clone https://github.com/ShubhanshuSondhiya/MCP-TMDB.git
cd MCP-TMDB

  2. 安装依赖

    npm install

  3. 配置 TMDB API 密钥

    • 在项目根目录下创建 '.env' 文件 (或者直接编辑 'src/config.ts' 文件)。
    • 添加你的 TMDB API 密钥： 
      TMDB_API_KEY=YOUR_TMDB_API_KEY
      注意: 你需要在 TMDB 官网 注册并获取 API 密钥。

  4. 构建项目

    npm run build

  5. 启动服务器

    npm start

    服务器成功启动后，你将在控制台看到 'TMDB MCP Server running...' 的日志信息。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端 (例如 Claude Desktop)，你需要提供服务器的启动命令和参数。以下是一个配置示例，你需要根据你的实际情况进行调整。

{
  "mcpServers": {
    "tmdb-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/your/MCP-TMDB/build/index.js"]
    }
  }
}

配置参数说明:

  • '"tmdb-mcp"': 服务器名称，可以自定义，用于在 MCP 客户端中标识此服务器。
  • '"command": "node"': 启动服务器的命令，这里使用 Node.js 运行时环境。
  • '"args": ["/absolute/path/to/your/MCP-TMDB/build/index.js"]': 启动命令的参数，指向服务器入口文件 'build/index.js' 的绝对路径。
    • 重要: 你需要将 '/absolute/path/to/your/MCP-TMDB' 替换为你本地 'MCP-TMDB' 仓库的实际绝对路径。例如，如果你的仓库在 'C:\Users\YourName\Documents\MCP-TMDB'，则应修改为 '["C:\Users\YourName\Documents\MCP-TMDB\build\index.js"]' (注意 Windows 路径中的反斜杠需要转义)。

在 Claude Desktop 中配置 (参考 README.md):

  1. 打开 Claude Desktop 客户端。
  2. 进入 "Settings" (设置) -> "Developer" (开发者) 选项卡。
  3. 点击 "Edit Config" (编辑配置) 按钮打开配置文件。
  4. 将上述 JSON 配置代码添加到配置文件中 'mcpServers' 字段下。
  5. 重启 Claude Desktop 客户端，配置即可生效。

基本使用方法

配置完成后，你可以在 MCP 客户端中使用以下方式与 TMDB MCP 服务器交互：

  • 使用静态资源: 在客户端中，你可以向 AI 助手提问，例如：

    • "What is TMDB?" (这是 'tmdb://info' 资源)
    • "Show me currently trending movies" (这是 'tmdb://trending' 资源)

  • 使用资源模板: 查询特定电影信息，例如：

    • "Get details about movie with ID 550" (查询 'tmdb://movie/550' 资源)
    • "Tell me about the movie with ID 155" (查询 'tmdb://movie/155' 资源)

  • 使用 Prompt 模板: 生成电影评论或推荐，例如：

    • "Write a detailed review for Inception with a rating of 9/10" (使用 'movie-review' Prompt)
    • "Recommend sci-fi movies for a thoughtful mood" (使用 'movie-recommendation' Prompt)

  • 使用工具: 执行电影搜索等操作，例如：

    • "Search for movies about space exploration" (调用 'search-movies' 工具)
    • "What are the trending movies today?" (调用 'get-trending' 工具)
    • "Find movies similar to The Matrix" (调用 'get-similar' 工具)

请参考仓库 'README.md' 文件中的 "Usage Examples" 部分获取更详细的使用示例。

信息

分类

数据库与文件

访问项目