AI导哈

媒体请求管理服务器

Overseerr MCP Server 是一个用于管理媒体请求的服务器，支持通过AI助手搜索媒体、查看请求和管理媒体请求。

  • by suckerfish
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 suckerfish/overseerr-mcp

使用说明

监督MCP服务器

MCP服务器 监督员 媒体请求管理。使AI助手能够通过模型上下文协议搜索媒体、查看请求和管理媒体请求。

特性

  • 搜索媒体 -按标题和可用性状态查找电影和电视节目
  • 媒体状态 -检查内容是否可用、是否正在处理或是否需要请求
  • 查看请求 -列出包含用户信息的请求，按审批状态、可用性状态或时间段进行筛选
  • 用户管理 -列出用户并查看单个请求历史记录
  • 请求媒体 -提交新的请求，包括每季电视节目的选择
  • 用户相关性 -轻松回答“列出上周的所有请求以及请求者”等问题

需求

  • Python 3.10+
  • 紫外线 包管理器
  • 具有管理员API密钥的Overserr实例

安装

Docker（推荐）

docker pull ghcr.io/suckerfish/overseerr-mcp:latest

来源

git clone https://github.com/suckerfish/overseerr-mcp.git
cd overseerr-mcp

# Create virtual environment and install dependencies
uv venv && uv pip install -e .

配置

复制 .env.example 到 .env 并配置：

OVERSEERR_URL=http://your-overseerr-ip:5055
OVERSEERR_API_KEY=your-admin-api-key-here

重要提示： 使用来自的管理员API密钥 设置→ 将军→ API密钥 在Overseer中（不是用户级密钥）。

用法

本地（标准传输）

uv run python -m src.server

HTTP传输（适用于Docker/remote）

uv run python -m src.server --transport streamable-http --host 0.0.0.0 --port 8080

码头工人

预构建图像可用于 linux/amd64 和 linux/arm64.

# Using docker compose (recommended)
docker compose up -d

# Or run directly
docker run -d \
  -e OVERSEERR_URL=http://your-overseerr:5055 \
  -e OVERSEERR_API_KEY=your-api-key \
  -p 8080:8080 \
  ghcr.io/suckerfish/overseerr-mcp:latest

MCP工具

工具 说明
search_media 按标题搜索电影/电视节目。返回TMDB ID、额定值和可用性状态。
get_media_status 检查特定TMDB ID的详细可用性状态。显示电视的请求状态、媒体可用性和季节计数
get_requests 列出带有用户信息的媒体请求。筛选依据 status （待定/批准）， media_status （可用/正在处理/不可用/失败），或 days.使用 show_all=true 以获取所有匹配项，而不是默认的20。
get_users 列出所有Overseer用户的请求计数。
get_user_requests 获取特定用户的请求。筛选依据 media_status （正在处理/可用等）。默认20个结果，使用 show_all=true 为了所有人。
request_media 请求观看电影或电视节目。电视节目需要为多季节目选择季节。
health_check 检查Overseer服务器连接和版本。

查询示例

连接到MCP客户端后，您可以问：

  • “搜索矩阵”-在线显示可用性状态
  • “《绝命毒师》可用吗？”-检查媒体状态
  • “列出上周的所有请求以及请求者”
  • “显示所有待处理的请求”
  • “哪些请求仍在处理中？”-按媒体可用性筛选
  • “用户ID 5请求了什么？”
  • “请求电影《黑客帝国》”
  • “《绝命毒师》第1-3季的请求”-每季电视请求

MCP客户端配置

克劳德桌面版

添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "overseerr": {
      "command": "uv",
      "args": ["run", "python", "-m", "src.server"],
      "cwd": "/path/to/plexrequest_mcp"
    }
  }
}

HTTP/Docker

{
  "mcpServers": {
    "overseerr": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

许可证

麻省理工学院

相关 MCP