TMDB MCP 服务器

该项目实现了一个与电影数据库 (TMDB) API 集成的模型上下文协议 (MCP) 服务器。它使像 Claude 这样的 AI 助手能够与电影数据交互，提供搜索、检索详细信息以及生成与电影相关的内容的功能。

特征

资源

• 静态资源：

  • tmdb://info - 有关 TMDB API 的信息

  • tmdb://trending - 当前热门电影

• 资源模板：

  • tmdb://movie/{id} - 有关特定电影的详细信息

提示

• 电影评论：生成具有指定风格和评级的定制电影评论

• 电影推荐：根据类型和心情获得个性化的电影推荐

工具

• 搜索电影：按标题或关键字查找电影

• 获取热门电影：检索当天或当周的热门电影

• 获取类似电影：查找与指定电影相似的电影

Related MCP server: TMDB MCP Server

设置说明

先决条件

• 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 桌面

2. 前往“设置”>“开发者”选项卡

3. 点击“编辑配置”打开配置文件

4. 将以下内容添加到您的配置中：

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

5. 重启Claude桌面

使用示例

使用静态资源

• “TMDB 是什么？”

• “显示当前热门电影”

使用资源模板

• “获取 ID 为 550 的电影的详细信息”（搏击俱乐部）

• “跟我讲讲 ID 为 155 的电影吧”（《黑暗骑士》）

使用提示

• “为《盗梦空间》撰写一份详细的评论，评分为 9/10”

• “推荐一些适合沉思的科幻电影”

使用工具

• “搜索有关太空探索的电影”

• “今天热门的电影有哪些？”

• “查找与《黑客帝国》类似的电影”

发展

项目结构

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 检查器测试您的服务器：

npx @modelcontextprotocol/inspector node build/index.js

执照

麻省理工学院

致谢

• 电影数据库（TMDB）

• 模型上下文协议