电影数据协议服务器

TMDB MCP服务器

该项目实现了一个与电影数据库（TMDB）API集成的模型上下文协议（MCP）服务器。它使像克劳德这样的人工智能助手能够与电影数据进行交互，提供搜索、检索细节和生成与电影相关内容的功能。

特性

资源

• 静态资源:

  • tmdb://info -关于TMDB API的信息
  • tmdb://trending -当前热门电影

• 资源模板:

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

鼓励

• 影评：生成具有指定风格和评级的自定义电影评论
• 电影推荐：根据类型和心情获得个性化的电影推荐

工具

• 搜索电影：按标题或关键字查找电影
• 获取热门电影：检索当天或每周的热门电影
• 获取类似电影：查找与指定电影类似的电影

安装说明

先决条件

• Node.js（v16或更高版本）
• npm或纱线
• 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桌面设置

1. 打开克劳德桌面
2. 转到“设置”>“开发人员”选项卡
3. 点击“编辑配置”打开配置文件
4. 将以下内容添加到您的配置中：

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

5. 重新启动克劳德桌面

使用示例

使用静态资源

• “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）
• 模型上下文协议