🚀 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 密钥
安装步骤
- 克隆此仓库：
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 许可证。