Overseerr MCP 是一个 Model Context Protocol（MCP）服务器，面向 Overseerr 及其统一后继版本 Seerr 构建，目标是让 AI 助手能够直接通过你的 Seer 实例搜索、请求和管理媒体，并借助 Model Context Protocol 完成集成。
用途 为 AI 助手提供连接 Overseerr/Seerr 的标准化能力，使其可以用自然语言完成媒体发现、请求提交、请求审批与状态查询等日常操作。
主要能力
- 性能优化：官方文本称批量操作可减少 99% 的 API 调用（从 150-300 次降至 1 次）；紧凑响应格式可降低 88% 的 token 消耗。
- 批量去重模式（Batch Dedupe Mode）：单次操作可检查 50-100 个标题。
- 智能缓存（Smart Caching）：可减少 70-85% 的 API 调用。
- 安全功能（Safety Features）：多季确认与输入校验。
- 工具集：提供 6 个工具，用于搜索、请求和管理媒体，并可发现 Radarr/Sonarr 服务器配置。
- 自动化安全扫描：Dependabot 每周更新依赖；CodeQL 对代码漏洞进行分析（PR + 每周）；Trivy 扫描 Docker 镜像（仅 CI，若发现漏洞则阻止 PR）；CI 在 PR 审查期间验证所有内容，CD 信任 CI 并发布。
- 加固 Docker 镜像：非 root 用户（mcpuser）、多阶段构建、最小化 Alpine 基础镜像、dumb-init 进程管理。
- 输入校验：对 URL 和 API key 格式进行校验，若失败会以清晰的错误信息快速失败。
使用方式 前置要求：Node.js 18.0 或更高版本；Seerr 或 Overseerr 实例（自托管或托管）；Seerr/Overseerr API key（在实例的 Settings → General 中获取）。
方式一：NPM（推荐） 配置 Claude Desktop，将内容添加到配置文件： macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json 文档指出，配置环境变量 SEERR_URL（你的 Seerr/Overseerr 实例 URL）与 SEERR_API_KEY（来自 Settings → General 的 API key）。
旧版 Overseerr 用户：如果仍在使用 Overseerr（而非 Seerr），可以继续使用旧版变量 OVERSEERR_URL 与 OVERSEERR_API_KEY。OVERSEERR_* 与 SEERR_* 变量均受支持以保持向后兼容，旧版变量将在 v3.0.0 中移除。
方式二：Docker（远程访问） 支持 Docker Compose。测试服务器后连接 MCP 客户端：
- Transport：Streamable HTTP
- URL：http://localhost:8085/mcp
方式三：从源码构建。
配置 环境变量：
- SEERR_URL：你的 Seerr/Overseerr 实例 URL
- SEERR_API_KEY：来自 Settings → General 的 API key
- 旧版（已弃用，将在 v3.0.0 移除）：OVERSEERR_URL（请改用 SEERR_URL）、OVERSEERR_API_KEY（请改用 SEERR_API_KEY） 可选变量：官方文本未列出具体可选变量名称与默认值，仅说明“Optional（with defaults）”，此处暂未提供。
使用示例 批量去重工作流（适合动漫季）：可一次性检查大量标题是否已请求。 带校验的媒体请求：如请求整季内容，会触发多季确认。 管理请求：查看待处理请求、审批请求等。 服务发现：查询已配置的 Radarr/Sonarr 服务器及其质量配置。 自然语言示例：可直接对 AI 助手说——
- “Search for Inception in Seerr”
- “Check if these 50 anime titles have been requested”
- “Request Breaking Bad all seasons”
- “Show me all pending media requests”
- “Approve request ID 123”
- “Get details for TMDB ID 550”
- “What Radarr servers are configured?”
- “Show me the quality profiles for my Sonarr server”
适用场景 适合需要以批量方式在 Overseerr/Seerr 中检查、请求和管理媒体，并希望通过 AI 助手（如 Claude Desktop 等 MCP 客户端）以自然语言完成这些操作的场景，尤其适合动漫整季批量去重、大规模标题检查与请求审批等工作流。
限制与说明 需要已有 Seerr 或 Overseerr 实例及对应 API key；需要 Node.js 18.0 或更高版本。文档中标注“可选（with defaults）”的变量具体内容暂未提供。旧版 OVERSEERR_* 变量将在 v3.0.0 中移除。项目采用 MIT License。
