TMDB MCP Server

TMDB MCP 服务

此项目实现了一个可与 The Movie Database（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. 前往 Settings > Developer 标签页
3. 点击 “Edit Config” 打开配置文件
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）

使用提示词

• “为 Inception 撰写一篇详细影评，评分为 9/10”
• “根据沉思的心情推荐科幻电影”

使用工具

• “搜索关于太空探索的电影”
• “今天有哪些热门电影？”
• “查找与 The Matrix 相似的电影”

开发

项目结构

tmdb-mcp/
├── src/
│   ├── index.ts                # Main server file
│   ├── config.ts               # Configuration and API keys
│   ├── handlers.ts             # Request handlers
│   ├── resources.ts            # Static resources
│   ├── resource-templates.ts   # Dynamic resource templates
│   ├── prompts.ts              # Prompt definitions
│   ├── tools.ts                # Tool implementations
│   └── tmdb-api.ts             # TMDB API wrapper
├── package.json
├── tsconfig.json
└── README.md

测试

在开发期间，使用 MCP Inspector 测试你的服务：

npx @modelcontextprotocol/inspector node build/index.js

许可证

MIT

致谢

• The Movie Database（TMDB）
• 模型上下文协议