TMDB MCP Server

Integrations

  • Enables searching, retrieving details, and accessing trending movies from The Movie Database (TMDB) API. Provides specific movie information by ID, similar movie recommendations, and supports generating custom movie reviews.

TMDB MCP 服务器

该项目实现了一个与电影数据库 (TMDB) API 集成的模型上下文协议 (MCP) 服务器。它使像 Claude 这样的 AI 助手能够与电影数据交互,提供搜索、检索详细信息以及生成与电影相关的内容的功能。

特征

资源

  • 静态资源
    • tmdb://info - 有关 TMDB API 的信息
    • tmdb://trending - 当前热门电影
  • 资源模板
    • tmdb://movie/{id} - 有关特定电影的详细信息

提示

  • 电影评论:生成具有指定风格和评级的定制电影评论
  • 电影推荐:根据类型和心情获得个性化的电影推荐

工具

  • 搜索电影:按标题或关键字查找电影
  • 获取热门电影:检索当天或当周的热门电影
  • 获取类似电影:查找与指定电影相似的电影

设置说明

先决条件

  • Node.js(v16 或更高版本)
  • npm 或 yarn
  • TMDB API 密钥

安装

  1. 克隆此存储库
    git clone https://github.com/your-username/tmdb-mcp.git cd tmdb-mcp
  2. 安装依赖项
    npm install
  3. 配置您的 TMDB API 密钥
    • 在项目根目录中创建一个.env文件(或者:直接编辑src/config.ts
    • 添加您的 TMDB API 密钥: TMDB_API_KEY=your_api_key_here
  4. 构建项目
    npm run build
  5. 启动服务器
    npm start

Claude Desktop 的设置

  1. 打开 Claude 桌面
  2. 前往“设置”>“开发者”选项卡
  3. 点击“编辑配置”打开配置文件
  4. 将以下内容添加到您的配置中:
{ "mcpServers": { "tmdb-mcp": { "command": "node", "args": ["/absolute/path/to/your/tmdb-mcp/build/index.js"] } } }
  1. 重启Claude桌面

使用示例

使用静态资源

  • “TMDB 是什么?”
  • “显示当前热门电影”

使用资源模板

  • “获取 ID 为 550 的电影的详细信息”(搏击俱乐部)
  • “跟我讲讲 ID 为 155 的电影吧”(《黑暗骑士》)

使用提示

  • “为《盗梦空间》撰写一份详细的评论,评分为 9/10”
  • “推荐一些适合沉思的科幻电影”

使用工具

  • “搜索有关太空探索的电影”
  • “今天热门的电影有哪些?”
  • “查找与《黑客帝国》类似的电影”

发展

项目结构

tmdb-mcp/ ├── src/ │ ├── index.ts # Main server file │ ├── config.ts # Configuration and API keys │ ├── handlers.ts # Request handlers │ ├── resources.ts # Static resources │ ├── resource-templates.ts # Dynamic resource templates │ ├── prompts.ts # Prompt definitions │ ├── tools.ts # Tool implementations │ └── tmdb-api.ts # TMDB API wrapper ├── package.json ├── tsconfig.json └── README.md

测试

在开发过程中使用 MCP 检查器测试您的服务器:

npx @modelcontextprotocol/inspector node build/index.js

执照

麻省理工学院

致谢

-
security - not tested
F
license - not found
-
quality - not tested

使 Claude 等 AI 助手能够与电影数据库 (TMDB) API 进行交互,提供搜索电影、检索电影详细信息以及生成定制电影评论和推荐的功能。

  1. Features
    1. Resources
    2. Prompts
    3. Tools
  2. Setup Instructions
    1. Prerequisites
    2. Installation
    3. Setup for Claude Desktop
  3. Usage Examples
    1. Using Static Resources
    2. Using Resource Templates
    3. Using Prompts
    4. Using Tools
  4. Development
    1. Project Structure
    2. Testing
  5. License
    1. Acknowledgements
      ID: ow3hfcwuot