mcp-server-tmdb

🚀 TMDB MCP 服务器

此 MCP 服务器集成了 The Movie Database (TMDB) API，可提供电影信息、搜索功能和推荐服务，为用户带来丰富的电影数据体验。

🚀 快速开始

在安装和运行 TMDB MCP 服务器之前，需确保满足以下先决条件。

📦 安装指南

所需软件

• Node.js

  • 版本要求：18.0.0 或更高
  • 下载地址：Node.js 官方网站
  • 验证安装：在命令行输入 node --version ，若显示版本号则安装成功。

• npm（Node 包管理器）

  • 版本要求：8.0.0 或更高（通常随 Node.js 一同提供）
  • 验证安装：在命令行输入 npm --version ，若显示版本号则安装成功。

• TypeScript

  • 作为项目依赖项会自动安装，也可全局安装，命令为 npm install -g typescript 。
  • 验证安装：在命令行输入 tsc --version ，若显示版本号则安装成功。

所需账户及 API 密钥

• TMDB 账户
  • 需在 TMDB 注册免费账户，并获取 API 密钥。
• Claude Desktop
  • 需登录到 Claude Desktop 账户。

系统要求

• 操作系统：支持 Windows、macOS 或 Linux。
• 内存：至少 512MB RAM。

开发环境

• 推荐使用 VS Code 或其他支持 Node.js 的 IDE。
• 可安装 Git（可选但推荐）。

✨ 主要特性

工具功能

搜索电影

npm install

获取流行电影

node index.js --get-popular-movies

根据 ID 获取电影

node index.js --get-movieById [movieId]

错误处理

该服务器具备全面的错误处理机制，可处理以下错误情况：

• 无效 API 密钥
• 网络错误
• 无效电影 ID
• 请求格式错误

错误信息将以用户友好的格式通过 Claude Desktop 返回。

💻 使用示例

基础用法

搜索电影

"Search for movies about artificial intelligence"

获取流行电影

"What are the trending movies today?"
"Show me this week's trending movies"

根据 ID 获取电影

"Tell me about the movie with ID 550"

🔧 技术细节

开发此服务器时，可使用以下命令进入开发模式：

npm run watch

📄 许可证

此 MCP 服务器根据 MIT License 分发。详细内容请参阅 LICENSE 文件。

🤝 贡献

欢迎大家贡献代码！请随意提交 Pull Request。

⚠️ 重要提示

以上所有内容均为翻译结果，若需使用，请确保内容的准确性和适用性。