TMDB MCP 服务器

该项目实现了一个与电影数据库（TMDB）API 集成的模型上下文协议（MCP）服务器。它使像 Claude 这样的 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. 将以下内容添加到您的配置中：

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

1. 重启 Claude Desktop

使用示例

使用静态资源

• “什么是 TMDB？”
• “显示当前热门电影”

使用资源模板

• “获取 ID 为 550 的电影详情”（搏击俱乐部）
• “告诉我 ID 为 155 的电影详情”（黑暗骑士）

使用提示

• “为盗梦空间写一篇详细的评论，评分为 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 Inspector 测试您的服务器：

npx @modelcontextprotocol/inspector node build/index.js

许可证

MIT

致谢

• The Movie Database (TMDB)
• Model Context Protocol