moviefinder-mcp

一个封装了 TMDB API 的 MCP 服务器，使支持 MCP 的客户端（如 Claude Desktop、Claude Code 等）能够搜索电影和电视节目、查看详细信息、查找热门内容、获取推荐以及查询影片的流媒体播放平台。

工具

所有工具均返回精简后的 JSON（包含 id、标题、年份、概述、评分、海报 URL 以及工具特定的字段），而非原始的 TMDB 负载。

设置

要求：Node 20+。

npm install
cp .env.example .env
# edit .env and paste your TMDB v4 read access token
npm run build
npm start    # runs the compiled server over stdio

获取 TMDB API 密钥

1. 在 https://www.themoviedb.org/ 创建一个 TMDB 账户。

2. 打开 https://www.themoviedb.org/settings/api。

3. 复制 API Read Access Token (v4 auth) —— 不是 v3 API 密钥。

4. 将其放入 .env 文件中，格式为 TMDB_API_KEY=...。

服务器会将其作为 Authorization: Bearer <token> 发送。

在 Claude Desktop 中注册

编辑 claude_desktop_config.json（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json，Windows: %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "moviefinder": {
      "command": "node",
      "args": ["/absolute/path/to/moviefinder-mcp/dist/index.js"],
      "env": {
        "TMDB_API_KEY": "your_v4_read_access_token_here"
      }
    }
  }
}

重启 Claude Desktop。上述工具将出现在 moviefinder 服务器下。

注意事项

• 流派列表 (/genre/movie/list) 会在首次获取后缓存在内存中，供 discover_movies 使用。

• 401 / 404 / 429 响应会以可操作的消息形式呈现。

• 在进行任何 TMDB 调用之前，输入内容都会通过 zod 进行验证。