TMDB MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供对 The Movie Database (TMDB) API 的访问。该服务器使 AI 助手能够通过 MCP 接口搜索和检索电影信息。

功能

• 按标题、年份和其他条件搜索电影
• 检索详细的电影信息
• 易于与 MCP 兼容的 AI 助手集成

前提条件

• Node.js >= 18
• TMDB API 密钥（从 TMDB 获取）

安装

1. 克隆存储库：

git clone https://github.com/rakeshgangwar/tmdb-mcp-server.git
cd tmdb-mcp-server

2. 安装依赖项：

npm install

3. 构建服务器：

npm run build

配置

在您的 MCP 设置文件（通常是 cline_mcp_settings.json）中配置 MCP 服务器：

{
  "mcpServers": {
    "tmdb": {
      "command": "node",
      "args": ["/path/to/tmdb-mcp-server/dist/index.js"],
      "env": {
        "TMDB_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

将 your-api-key-here 替换为您的 TMDB API 密钥，并将 /path/to/ 替换为实际路径。

可用工具

search_movies

使用 The Movie Database API 搜索电影。

参数：

• query (必需): 搜索查询字符串
• year (可选): 按发行年份过滤
• page (可选): 页码（默认值：1）

示例：

{
  "query": "Inception",
  "year": 2010,
  "page": 1
}

开发

1. 在 src 目录中进行更改
2. 构建项目：

npm run build

3. 通过在您的设置中配置 MCP 服务器来测试您的更改

贡献

1. Fork 存储库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -am 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

鸣谢

• TMDB API 提供电影数据库 API
• Model Context Protocol 提供 MCP SDK