AI导哈

电影数据库API访问服务

该服务为Claude等MCP客户端提供对The Movie Database API的完整访问，支持查询电影信息、演员详情及流行趋势等功能。

  • by Ghaziyassine
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Ghaziyassine/TMDB-mcp-server

使用说明

🎬 TMDB MCP服务器

允许Claude（或任何MCP客户）完全访问电影数据库API。 无npm依赖——使用Node.js 18+原生 fetch.

MCP工艺流程图

┌─────────────────────────────────────────────────────┐
│  MCP Host (Claude Desktop / Gemini CLI)             │
│                                                     │
│  1. spawn node index.js                             │
│  2. initialize handshake                            │
│  3. inject tool list into LLM system prompt         │
│                                                     │
│  User: "trending movies this week?"                 │
│     ↓  LLM decides to call get_trending             │
│  4. tools/call → stdin                              │
│                    ↓                                │
│             ┌─────────────────┐                     │
│             │  Node.js Server │                     │
│             │  handleRequest()│                     │
│             │  handleToolCall │                     │
│             │  tmdb() fetch   │──── GET ───→ TMDB   │
│             │  formatMovie()  │←─── JSON ──── TMDB  │
│             └─────────────────┘                     │
│                    ↓                                │
│  5. result → stdout → LLM context                   │
│  6. Claude formule sa réponse finale                │
└─────────────────────────────────────────────────────┘

快速开始

1.获得免费TMDB API密钥

👉 https://www.themoviedb.org/settings/api
（创建免费帐户→ 设置→ API → 请求API密钥）

2.设置密钥

export TMDB_API_KEY=your_key_here

3.运行服务器

node index.js

连接到克劳德桌面

编辑您的Claude Desktop配置：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tmdb": {
      "command": "node",
      "args": ["/absolute/path/to/tmdb-mcp-server/index.js"],
      "env": {
        "TMDB_API_KEY": "your_key_here"
      }
    }
  }
}

重新启动克劳德桌面。你会看到一个🔌 icon——克劳德现在可以查询电影了！

连接到克劳德代码

TMDB_API_KEY=your_key claude mcp add tmdb node /absolute/path/to/index.js

连接到Gemini CLI

编辑Gemini CLI配置：

窗户： %USERPROFILE%\.gemini\settings.json
macOS/Linux： ~/.gemini/settings.json

添加 mcpServers 章节：

{
  "mcpServers": {
    "tmdb": {
      "command": "node",
      "args": ["/absolute/path/to/index.js"],
      "env": {
        "TMDB_API_KEY": "your_api_key_here"
      }
    }
  }
}

替换 /absolute/path/to/index.js 根据您的实际路径和 your_api_key_here 使用TMDB API密钥。保存后重新启动Gemini CLI。

可用工具

工具 克劳德可以问什么
search_movies “寻找名为《盗梦空间》的电影”
get_movie_details “获取电影ID 27205的详细信息”
get_trending “本周流行什么电影？”
get_now_playing “现在剧院里有什么？”
get_top_rated “有史以来收视率最高的电影是什么？”
discover_movies “查找评分在7分以上的90年代动作片”
search_person “查找有关克里斯托弗·诺兰的信息”
get_movie_credits 《星际穿越》的演员阵容中有谁

克劳德对话示例

连接后，您可以问Claude以下问题：

  • “本周的热门电影是什么？”
  • “找到我2010年至2020年评分高于7.5的科幻电影”
  • “谁执导了《黑暗骑士》，演员阵容中有谁？”
  • “现在剧院里演什么？”
  • “查找按评级排序的恐怖电影”

类型ID（用于discover_movies）

ID 类型
28 行动
12 冒险
16 动画
35 喜剧
80 犯罪
99 纪录片
18 戏剧
27 恐怖
10749 浪漫
878 科幻小说
53 惊悚片
37 西部

运作原理

You → Claude → MCP tool call → TMDB REST API → data back to Claude → answer

服务器将Claude的工具调用转换为TMDB API请求， 清理响应（去除噪声）并将数据交还给Claude。

相关 MCP