TMDB

🚀 TMDB MCP 服務器

該項目實現了一個集成 The Movie Database (TMDB) API 的 Model Context Protocol (MCP) 服務器。它讓像 Claude 這樣的 AI 助手能夠與電影數據進行交互，具備搜索電影、獲取詳細信息以及生成相關內容等功能。

🚀 快速開始

本項目實現的 TMDB MCP 服務器，可使 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 Desktop
2. 轉到設置 > 開發人員選項卡
3. 點擊“編輯配置”以打開配置文件
4. 添加以下內容到你的配置中：

{
  "mcpServers": {
    "tmdb-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/your/tmdb-mcp/build/index.js"]
    }
  }
}

5. 重啟 Claude Desktop

💻 使用示例

基礎用法

使用靜態資源

• “什麼是 TMDB？”
• “顯示當前流行的電影”

使用資源模板

• “獲取 ID 為 550 的電影詳情”（Fight Club）
• “告訴我關於 ID 155 的電影的信息”（The Dark Knight）

使用提示語

• “寫一篇對《盜夢空間》的詳細評論，評分 9/10”
• “推薦適合思考心情的科幻電影”

使用工具

• “搜索有關太空探索的電影”
• “今天有哪些流行電影？”
• “查找與《矩陣》類似的電影”

🔧 技術細節

項目結構

tmdb-mcp/
├── src/
│   ├── index.ts                # 主服務器文件
│   ├── config.ts               # 配置和 API 密鑰
│   ├── handlers.ts             # 請求處理程序
│   ├── resources.ts            # 靜態資源
│   ├── resource-templates.ts   # 動態資源模板
│   ├── prompts.ts              # 提示定義
│   ├── tools.ts                # 工具實現
│   └── tmdb-api.ts             # TMDB API 包裝器
├── package.json
├── tsconfig.json
└── README.md

測試

在開發期間使用 MCP 檢查器測試你的服務器：

npx @modelcontextprotocol/inspector node build/index.js

📄 許可證

MIT

致謝

• The Movie Database (TMDB)
• Model Context Protocol