Overseerr MCP Server

监督MCP服务器

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

特性

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

安装

1. 克隆仓库或复制代码

mkdir overseerr-mcp-server
cd overseerr-mcp-server

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

1. 安装依赖关系

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 已设置

1. 连接错误

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

1. API错误

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

调试Modus

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

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

许可证

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