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。

⚠️ 重要提示

以上所有內容均為翻譯結果，若需使用，請確保內容的準確性和適用性。