🚀 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 键：从 TMDB 仪表盘获取 API 键，获取后需要经过 TMDB 审核才能获得访问权限。

系统需求

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

开发环境

推荐使用代码编辑器（如 VS Code）进行开发。

📦 安装指南

方式一：手动安装

1. 复制仓库地址并运行以下命令克隆仓库：

git clone [repository-url]

2. 进入项目目录并安装依赖：

cd mcp-server-tmdb
npm install

方式二：使用 Smithery CLI 安装

npm install -y @smithery/cli 
npx smithery install @Laksh-star/mcp-server-tmdb --client claude

✨ 主要特性

此 MCP 服务器具备以下强大功能：

1. 电影信息查询：可快速查询各类电影的详细信息。
2. 智能搜索服务：支持多语言关键词搜索，搜索结果按相关性排序。
3. 个性化推荐系统：基于电影 ID 提供推荐服务，采用协同过滤和内容分析技术，并通过用户反馈机制优化推荐结果。
4. 热门影片排行榜：展示当下热门的影片。
5. 错误处理与用户反馈：全面处理各种错误情况，并以用户友好的方式返回错误信息。

🔍 工具介绍

搜索工具

• 支持关键词搜索（如“人工智能相关电影”）。
• 提供多语言支持。
• 搜索结果按 relevance 排序。

推荐系统

• 基于电影 ID 的推荐服务。
• 算法采用协同过滤和内容分析技术。
• 通过用户反馈机制优化推荐结果。

💻 使用示例

基础用法

以下是一些常见的使用示例：

1. 搜索电影：

"Search for movies about artificial intelligence"

2. 查询热门影片：

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

3. 获取推荐：

"Get movie recommendations based on movie ID 550"

4. 查看电影详情：

"Tell me about the movie with ID 550"

🔧 技术细节

错误处理

服务器包含全面的错误处理功能，可处理以下错误情况：

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

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

开发模式

在开发过程中，您可以使用以下命令实时监控代码变化：

npm run watch

📄 许可证

此 MCP 服务器根据 MIT License 发布。有关详细信息，请参阅 LICENSE 文件。

🤝 贡献指南

欢迎大家积极贡献！请随意提交 Pull Request。