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)