AI导哈

电影和系列搜索服务

MCP-TMDB是一个结合Claude AI和TMDB电影与系列数据的服务，支持自然语言搜索、过滤搜索、相似性搜索等功能，适用于电影和电视节目的推荐与发现。

  • by Mokkatrukki
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Mokkatrukki/mcp-tmdb

使用说明

MCP-TMDB

“今天看什么？”

MCP服务器，将Claude的聊天智能与TMDB的电影和电视剧数据相结合。 您可以用自然语言编写 — 服务器理解您要查找的内容并查找正确的数据。

这能做什么

自然语言（smart_search)

输入任何内容，服务器将解释：

"Tom Hanksin näyttelemät sotaelokuvat"
"samanlaisia sarjoja kuin Downton Abbey, saatavilla Yle Areenassa tai Amazon Primessä"
"parhaat vakavat Gundam-sarjat"
"tummia psykologisia trillereitä 2010-luvulta"
"mitä anime-sarjoja trendaa nyt"
"Nolan-elokuvat parhaimmasta huonoimpaan"

智能搜索可自动识别：

  • 寻找电影或系列
  • 无论是推荐，搜索，个人还是特许经营
  • 什么流媒体服务有趣
  • 哪种语言的作品（动漫→日语，k-drama→韩语等）

过滤器搜索（discover)

按类型、年份、评分、语言、流媒体服务或演员过滤。 支持多种服务：“来自Netflix或Disney Plus”。

寻求平等（similar_to)

输入参考作品，您将获得主题类似的结果。 同时搜索 TMDB 建议和基于关键字的发现搜索。 双子座排名结果 — 不仅仅是受欢迎程度。

特许经营哈库

搜索特定特许经营的所有系列或电影：

"kaikki Turtles-sarjat"
"parhaat Star Wars -elokuvat"

电影资讯 + 续集 （get_details)

使用 TMDB ID 查找电影信息。如果电影是收藏品 （例如：Blade Runner、Star Wars），将自动显示所有部分。

其他工具

工具 描述
search_by_title 寻找电影或系列的名称
search_person 寻找演员或导演
get_person 个人信息和主要角色
get_recommendations TMDB 建议使用作品 ID
trending 目前最热门的电影/系列
list_genres 所有可用的类型。
list_watch_providers 芬兰的直接服务

安装

1. 克隆并安装依赖关系

git clone https://github.com/Mokkatrukki/mcp-tmdb.git
cd MCP-tmdb
uv sync

2.罗 .env文件

cp .env.example .env   # tai luo käsin

更多密钥 ：

TMDB_API_KEY_V3=sinun_tmdb_api_avain
GEMINI_API_KEY=sinun_gemini_api_avain

3.罗 .mcp.json Claude Codea 的

cp .mcp.json.example .mcp.json

编辑 .mcp.json正确的路径：

{
  "mcpServers": {
    "tmdb": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/absoluuttinen/polku/MCP-tmdb"
    }
  }
}

4. 测试

uv run python server.py

服务器应该启动并加载流派，流媒体服务和关键字缓存。

使用 Claude Code

坤 .mcp.json 就位，在项目文件夹中启动Claude Code。 服务器将自动连接。您可以测试：

/mcp

之后，您可以直接使用：

Hae minulle Tom Hanksin parhaat elokuvat
Mitä sarjoja on trendannut tällä viikolla?
Samanlaisia kuin Breaking Bad

技术文件

  • FLOWS.md — 解释了架构、调用链和smart_search路径。如果你想了解系统内部是如何工作的话，这是一个很好的阅读。
  • CLAUDE.md — Claude Codelle 项目开发指南。
  • VISION.md 原始愿景和设计原则。

堆栈

  • Python 3.11+ + uv 包 管理
  • FastMCP （Anthropic 官方 MCP SDK）
  • httpx — async HTTP 调用 TMDB
  • DSPY — 调查排名和结果排序 （Gemini 2.5 Flash Lite）
  • TMDB API v3 电影 和 系列

限制

  • 芬兰的直达服务和年龄限制（region=FI）
  • 中文回复（TMDB 会在可用时返回中文描述）
  • 智能搜索需要Gemini API密钥
  • TMDB个人资料有时不完整（角色可能丢失）

相关 MCP