TMDB MCP Server

该项目实现了一个与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的电影详情"（《搏击俱乐部》）
• "告诉我关于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