MCP TMDB

🚀 TMDB MCP 服務器

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

🚀 快速開始

本項目實現了一個與 The Movie Database (TMDB) API 集成的 Model Context Protocol (MCP) 服務器，讓 AI 助手（如 Claude）能與電影數據交互。以下為你介紹如何快速搭建並使用該服務器。

✨ 主要特性

資源

• 靜態資源：
  • 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 (MCP)