影视搜索服务

TMDB MCP服务器

一种模型上下文协议（MCP）服务器，允许LLM使用电影数据库（TMDB）API搜索电影和电视节目。

特性

• 搜索电影：按标题查找电影，并支持地区和语言。
• 搜索电视节目：按标题查找支持语言的电视节目。
• 获取详细信息：检索电影和电视节目的详细元数据（运行时间、预算、季节等）。
• 趋势：发现今天或本周的热门电影和电视节目。
• 搜索人员：寻找演员、导演和其他工作人员。
• 直接链接：提供TMDb URL，便于访问更多详细信息。

先决条件

• Node.js （v18或更高版本）
• TMDB API密钥。您可以通过在上创建帐户来获得一个 themoviedb.org 以及在您的帐户设置中申请API密钥。

配置

MCP客户端配置（例如，克劳德桌面）

要将此服务器与Claude Desktop一起使用，请将其添加到您的 claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tmdb": {
      "command": "npx",
      "args": ["-y", "@lonzzi/tmdb-mcp-server"],
      "env": {
        "TMDB_API_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具

所有工具都支持可选 language 论点（例如。， en-US, zh-CN, fr-FR)以获得本地化结果。默认值为 en-US.

search_movies

在TMDB上按标题搜索电影。

• 参数:
  • query （string，必填）：要搜索的电影标题。
  • language （字符串，可选）：语言代码（默认值： en-US).
  • region （字符串，可选）：用于过滤发布日期的ISO 3166-1代码（例如。， US, KR).

search_tv_shows

按标题搜索TMDB上的电视节目。

• 参数:
  • query （string，必填）：要搜索的电视节目标题。
  • language （字符串，可选）：语言代码（默认值： en-US).

get_movie_details

获取特定电影的详细信息。

• 参数:
  • movieId （数字，必填）：电影的TMDB ID。
  • language （字符串，可选）：语言代码（默认值： en-US).

get_tv_show_details

获取特定电视节目的详细信息。

• 参数:
  • tvShowId （数字，必填）：电视节目的TMDB ID。
  • language （字符串，可选）：语言代码（默认值： en-US).

get_trending_movies

获取每日或每周的热门电影。

• 参数:
  • timeWindow （字符串，可选）： day 或 week （默认值： week).
  • language （字符串，可选）：语言代码（默认值： en-US).

get_trending_tv

获取每日或每周的热门电视节目。

• 参数:
  • timeWindow （字符串，可选）： day 或 week （默认值： week).
  • language （字符串，可选）：语言代码（默认值： en-US).

search_person

搜索人物（演员、导演等）。

• 参数:
  • query （string，必填）：要搜索的名称。
  • language （字符串，可选）：语言代码（默认值： en-US).

发展

1. 克隆存储库：

   复制

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

2. 安装依赖项：

   复制

   npm install
   

3. 创建一个 .env 与您的文件 TMDB_API_KEY.

4. 构建项目：

   复制

   npm run build
   

运行测试

npm test