金大哥 - TMDB MCP 详情

article

README

🚀 TMDB MCP 服务器

该项目实现了一个集成 The Movie Database (TMDB) API 的 Model Context Protocol (MCP) 服务器。它让像 Claude 这样的 AI 助手能够与电影数据交互，提供搜索、获取详细信息和生成相关内容的功能。

🚀 快速开始

TMDB MCP 服务器可使 AI 助手与电影数据交互。以下是使用该服务器的基本步骤：

完成安装（见下方“📦 安装指南”）。
配置用于 Claude Desktop（见下方“配置用于 Claude Desktop”）。
参考“💻 使用示例”进行操作。

✨ 主要特性

资源

静态资源：
- tmdb://info - 关于 TMDB API 的信息
- tmdb://trending - 目前正在流行的电影
资源模板：
- tmdb://movie/{id} - 特定电影的详细信息

提示语

电影评论：根据指定风格和评分生成定制化电影评论
电影推荐：基于类型和心情获取个性化电影推荐

工具

搜索电影：通过标题或关键字查找电影
获取流行电影：获取当天或当周的流行电影
获取类似电影：查找与指定电影类似的电影

📦 安装指南

依赖项

Node.js (v16 或更高版本)
npm 或 yarn
TMDB API 密钥

安装步骤

克隆此仓库

git clone https://github.com/your-username/tmdb-mcp.git
cd tmdb-mcp

安装依赖项
```
npm install
```
配置你的 TMDB API 密钥
- 在项目根目录创建一个 .env 文件（或直接编辑 src/config.ts）
- 添加你的 TMDB API 密钥：TMDB_API_KEY=your_api_key_here
构建项目
```
npm run build
```
启动服务器
```
npm start
```

配置用于 Claude Desktop

打开 Claude Desktop。
转到设置 > 开发人员选项卡。
点击“编辑配置”以打开配置文件。

添加以下内容到你的配置中：

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

重启 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

TMDB