TMDB MCP Server 快速开始指南

简介

TMDB MCP 服务器与 The Movie Database (TMDB) API 集成，提供电影信息、搜索功能和推荐服务。

前提条件

• Node.js (v18.0.0+) 和 npm (v8.0.0+)
• TMDB 账户和 API 密钥 (TMDB官网)
• Claude 桌面应用程序

功能

• search_movies: 按标题或关键词搜索电影
• get_recommendations: 根据电影ID获取推荐
• get_trending: 获取当日/当周热门电影
• 电影资源: 通过 tmdb:///movie/<movie_id> 访问电影详情

安装方法

方法1: 通过 Smithery (推荐)

npx -y @smithery/cli install @Laksh-star/mcp-server-tmdb --client claude

方法2: 手动安装

1. 克隆并安装依赖项:

git clone [仓库URL]
cd mcp-server-tmdb
npm install
npm run build

2. 配置 Claude Desktop:

编辑 ~/Library/Application Support/Claude/config.json:

{
  "mcpServers": {
    "tmdb": {
      "command": "/完整/路径/to/dist/index.js",
      "env": {
        "TMDB_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用示例

"搜索关于人工智能的电影"
"今天的热门电影有哪些?"
"根据电影ID 550给我推荐电影"
"告诉我ID为550的电影详情"

故障排除

如遇问题，请检查:

• API 密钥是否有效
• 网络连接是否正常
• 请求格式是否正确

许可证

MIT 许可证