AI导哈

媒体请求管理服务器

Overseerr MCP Server是一个用于管理媒体请求的服务器，支持通过Claude等AI助手进行电影和电视节目的搜索、请求和管理。

  • by edemal
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 edemal/mcp-server-overseerr

使用说明

监督MCP服务器

Overseerr的模型上下文协议（MCP）服务器，允许通过Claude和其他兼容的人工智能助手使用Overseerr功能。

特性

  • 搜索媒体在 TMDB 数据库中搜索电影和电视节目
  • 管理查询查看、过滤和排序所有媒体查询
  • 请求媒体请求新电影或电视剧
  • 批准请求批准未决请求
  • 拒绝请求拒绝有理由的请求
  • 媒体详情获取有关电影/系列的详细信息
  • 状态查看 Overseerr 服务器状态和信息
  • 用户查询显示针对特定用户的请求

安装

  1. 克隆仓库或复制代码
mkdir overseerr-mcp-server
cd overseerr-mcp-server

  1. 创建文件将 TypeScript 代码复制到 src/index.ts 其他配置文件

  2. 安装依赖关系

npm install
  1. 建立 build
npm run build

配置

环境变量

创建一个 .env 文件或设置以下环境变量：

# Erforderlich: Overseerr API Key
OVERSEERR_API_KEY=your_api_key_here

# Optional: Overseerr Base URL (Standard: http://localhost:5055)
OVERSEERR_BASE_URL=http://localhost:5055

获取API密钥

  1. 打开您的 Overseerr Web 界面
  2. 进入 设置 → 将军
  3. 滚动到 API密钥 然后复制钥匙
  4. 把它设置为 OVERSEERR_API_KEY 环境变量

Claude桌面集成

在您的 Claude 桌面配置中添加 （claude_desktop_config.json）添加：

{
  "mcpServers": {
    "overseerr": {
      "command": "node",
      "args": ["path/to/overseerr-mcp-server/build/index.js"],
      "env": {
        "OVERSEERR_API_KEY": "your_api_key_here",
        "OVERSEERR_BASE_URL": "http://localhost:5055"
      }
    }
  }
}

可用工具

search_media

搜索电影和电视剧

Parameter:
- query (string): Suchbegriff
- page (number, optional): Seitenzahl für Paginierung

get_requests

显示所有媒体查询

Parameter:
- take (number, optional): Anzahl Ergebnisse (Standard: 20)
- skip (number, optional): Übersprungene Ergebnisse (Standard: 0)
- filter (string, optional): Filter nach Status (all, approved, denied, pending, processing, available)
- sort (string, optional): Sortierung (added, modified)

request_media

需要一个媒体

Parameter:
- mediaId (number): TMDB ID des Mediums
- mediaType (string): "movie" oder "tv"
- seasons (array, optional): Staffeln für TV-Serien
- is4k (boolean, optional): 4K-Version anfordern

approve_request

批准请求

Parameter:
- requestId (number): ID der zu genehmigenden Anfrage

deny_request

拒绝请求

Parameter:
- requestId (number): ID der abzulehnenden Anfrage
- reason (string, optional): Ablehnungsgrund

get_media_details

显示详细的媒体信息

Parameter:
- mediaType (string): "movie" oder "tv"
- mediaId (number): TMDB ID

get_server_status

显示服务器状态和信息

Parameter: keine

get_user_requests

显示特定用户的请求

Parameter:
- userId (number): Benutzer-ID
- take (number, optional): Anzahl Ergebnisse
- skip (number, optional): Übersprungene Ergebnisse

使用范例

安装后，您可以询问Claude：

  • 电影《Inception》
  • “显示所有未决媒体查询”
  • “Fordere den电影《黑客帝国》”
  • “使用 ID 123 批准请求”
  • “显示 Overseerr 服务器的状态”

发展

对于开发，您可以使用开发模式：

npm run dev

故障排除

常见问题

  1. “需要OVERSEERR_API_KEY环境变量”

    • 确保环境变量 OVERSEERR_API_KEY 已设置

  2. 连接错误

    • 检查Overseerr是否正在运行并且可以通过配置的URL访问
    • 默认情况下，Overseerr 在端口 5055 上运行

  3. API错误

    • 检查API密钥是否正确
    • 确保用户拥有必要的权限

调试Modus

有关高级调试信息，您可以查看日志：

# Server direkt ausführen für Logs
node build/index.js

许可证

使用许可证 - 详情请参阅许可证文件。

相关 MCP