Overseerr MCP

基本能力

产品定位

Overseerr MCP 是一个媒体请求管理工具，通过自然语言交互简化媒体搜索和请求流程。

核心功能

1. 媒体搜索
2. 支持电影、电视节目和人物的搜索
3. 提供详细的媒体信息，包括标题、发布日期、剧情概述、可用状态和请求状态
4. 支持按媒体类型（电影/电视/人物）筛选

5. 支持自然语言查询（如“查找最近的科幻电影”或“搜索类似《绝命毒师》的节目”）

6. 媒体请求

7. 支持电影和电视节目的请求
8. 可以为电视节目指定特定季节
9. 跟踪请求状态
10. 获取请求更新的通知

11. 支持自然语言请求（如“请求最新的蝙蝠侠电影”或“将《继承之战》添加到我的观看列表”）

12. 集成能力

13. 通过 stdio 传输与 Claude AI 无缝集成
14. 实时与 Overseerr 实例交互
15. 安全的 API 密钥处理
16. 速率限制和错误处理
17. 通过环境变量轻松配置

适用场景

• 用户希望通过自然语言快速搜索和请求媒体内容
• 用户需要管理 Overseerr 实例中的媒体请求
• 开发者希望集成 Claude AI 与 Overseerr 进行自动化媒体管理

工具列表

1. 搜索媒体 (overseerr:search)
2. 功能：在 Overseerr 数据库中搜索电影、电视节目和人物

3. 参数：

   • query：搜索查询（可以是标题、人物或一般描述）
   • type（可选）：筛选类型（movie、tv 或 person）

4. 请求媒体 (overseerr:request)

5. 功能：请求电影或电视节目添加到媒体库
6. 参数：
   • mediaId：媒体的 TMDB ID
   • mediaType：媒体类型（movie 或 tv）
   • seasons（可选）：为电视节目指定季节

常见问题解答

• 如何配置 Overseerr URL 和 API 密钥？ 通过环境变量 OVERSEERR_URL 和 OVERSEERR_API_KEY 配置。
• 如何启动服务器？ 运行 pnpm start 命令。
• 如何调试连接问题？ 检查环境变量是否正确配置，并确保 Overseerr 实例可访问。

使用教程

使用依赖

1. 安装 Node.js
2. 安装 pnpm
3. 安装 Claude Desktop
4. 准备一个 Overseerr 实例

安装教程

1. 安装依赖： bash pnpm install
2. 构建项目： bash pnpm build
3. 配置环境： bash cp .env.template .env # 编辑 .env 文件，填写你的 Overseerr URL 和 API 密钥
4. 配置 Claude Desktop（参考 README 中的 JSON 配置示例）
5. 启动服务器： bash pnpm start

调试方式

1. 检查环境变量是否正确配置
2. 确保 Overseerr 实例可访问
3. 查看服务器日志以排查错误
4. 使用 overseerr:search 和 overseerr:request 工具测试功能

许可证

该项目遵循 MIT 开源许可条款。