返回 MCP 目录
public公开dns本地运行

Laksh-star_mcp-server-tmdb

一个基于TMDB API的电影信息查询MCP服务器,提供电影搜索、推荐和趋势查询功能,支持与Claude桌面应用集成。

article

README

🚀 TMDB MCP 服务器

TMDB MCP 服务器与电影数据库(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 注册免费账户。
    • 从 TMDB 仪表盘获取 API 密钥,且 API 访问需要通过 TMDB 审批。
  • Claude 桌面应用程序
    • 需安装最新版本,并具备修改配置文件的权限。

系统要求

  • 操作系统:支持 macOS(10.15 或更高)、Windows 10/11 以及 Linux(现代发行版)。
  • 硬件需求:至少 4GB 内存、1GB 空闲磁盘空间,且需要稳定的互联网连接。

开发环境

为获得最佳开发体验,推荐使用具备 TypeScript 支持的代码编辑器(如 VS Code),拥有终端访问权限,并安装 Git 用于版本控制。

安装

使用 npm 进行全局安装:

npm install -g tmdb

使用

全局命令

在终端中运行:

tmdb [command]

常用命令

  • 初始化项目
tmdb init
  • 启动开发服务器
tmdb dev

✨ 主要特性

工具

  • tmdb:提供与 TMDB API 的交互功能。

资源

  • Movie DB:可操作电影数据库。

🔧 技术细节

错误处理

状态码

  • 200:表示成功。
  • 401:代表认证失败。
  • 404:意味着资源未找到。
  • 500:表示服务器错误。

异常处理

tmdb: 错误:无法连接到 TMDB 服务

开发

在开发期间,可使用以下命令监视更改:

npm run watch

📄 许可证

此 MCP 服务器根据 MIT 许可证发布。有关详细信息,请参阅 LICENSE 文件。

🤝 贡献

欢迎大家贡献代码!请随意提交拉取请求。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端