Skip to main content
Glama
enesjakozh

Overseerr MCP Server

by jmagar
GitHub
TypeScript
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

监督员 MCP

Overseerr 的模型上下文协议 (MCP) 集成，可通过 Claude AI 与您的媒体请求系统进行自然语言交互。此服务器允许您搜索电影和电视节目、发出媒体请求，并使用对话式语言管理您的 Overseerr 实例。

对话示例

以下是使用此服务器与 Claude 进行的一些示例对话：

You: Can you find any recent sci-fi movies? Claude: Let me search for recent science fiction films... [Uses overseerr:search to find recent sci-fi movies] You: That looks good! Can you request the second one? Claude: I'll request that movie for you... [Uses overseerr:request to submit the media request] You: What TV shows are available about cooking? Claude: I'll search for cooking-related TV shows... [Uses overseerr:search with type='tv' to find cooking shows]

特征

媒体搜索

  • 搜索电影、电视节目和人物

  • 获取有关媒体的详细信息，包括：

    • 标题和发布日期

    • 剧情概述

    • 可用性状态

    • 请求状态

  • 按媒体类型过滤（电影/电视/人物）

  • 自然语言查询（例如，“查找最近的科幻电影”或“搜索像《绝命毒师》这样的节目”）

媒体请求

  • 请求电影和电视节目

  • 指定电视节目的单独季节

  • 跟踪请求状态

  • 获取有关请求更新的通知

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

一体化

  • 通过 stdio 传输实现无缝 Claude AI 集成

  • 与您的 Overseerr 实例进行实时交互

  • 安全 API 密钥处理

  • 速率限制和错误处理

  • 通过环境变量轻松配置

设置

先决条件

  • Node.js

  • 下午

  • 克劳德桌面

  • 监督者实例

快速入门

  1. 安装依赖项：

pnpm install

  1. 构建项目：

pnpm build

  1. 配置环境：

# Copy template cp .env.template .env # Edit .env with your values OVERSEERR_URL=your_overseerr_url OVERSEERR_API_KEY=your_api_key

  1. 配置Claude桌面：

Linux/Mac：

{ "overseerr": { "command": "node", "args": ["/path/to/overseerr/packages/server/dist/index.js"], "cwd": "/path/to/overseerr", "transport": { "type": "stdio" }, "env": { "OVERSEERR_URL": "your_overseerr_url", "OVERSEERR_API_KEY": "your_api_key" } } }

Windows（注意双反斜杠）：

{ "overseerr": { "command": "node", "args": ["C:\\path\\to\\overseerr\\packages\\server\\dist\\index.js"], "cwd": "C:\\path\\to\\overseerr", "transport": { "type": "stdio" }, "env": { "OVERSEERR_URL": "your_overseerr_url", "OVERSEERR_API_KEY": "your_api_key" } } }

  1. 启动服务器：

pnpm start

技术细节

项目结构

packages/ ├── config/ # Configuration management ├── overseerr/ # Overseerr API client ├── server/ # MCP server implementation └── shared/ # Shared types and utilities

可用工具

搜索媒体（ overseerr:search ）

在 Overseerr 数据库中搜索电影、电视节目和人物。

{ // The search query - can be a title, person, or general description query: string, // Optional: Filter by type // - 'movie': Only search movies // - 'tv': Only search TV shows // - 'person': Only search people type?: 'movie' | 'tv' | 'person' }

示例查询：

  • 《寻找盗梦空间》

  • “查找 2023 年的电视节目”

  • “寻找汤姆·汉克斯主演的电影”

请求媒体（ overseerr:request ）

请求将电影或电视节目添加到您的媒体库。

{ // The TMDB ID of the media to request mediaId: number, // Type of media being requested // - 'movie': Request a movie // - 'tv': Request a TV show mediaType: 'movie' | 'tv', // Optional: For TV shows, specify which seasons to request // If not provided, requests all available seasons seasons?: number[] }

示例请求：

  • 点播电影：“点播《黑客帝国》”

  • 请求特定季节：“添加《办公室》第 1-3 季”

  • 请求观看所有季：“请求观看《绝命毒师》全集”

配置

环境变量

  • OVERSEERR_URL ：您的 Overseerr 实例 URL

  • OVERSEERR_API_KEY ：您的 Overseerr API 密钥

错误处理

服务器实现了强大的错误处理：

  • 带有有意义消息的 API 错误

  • 速率限制保护

  • 请求验证

  • 连接错误恢复

贡献

  1. 分叉存储库

  2. 创建功能分支

  3. 提交你的更改

  4. 推送到分支

  5. 创建拉取请求

执照

麻省理工学院

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

允许 Claude 与 Overseerr 交互，使用户能够通过自然语言搜索、请求和管理他们的 Plex 库的媒体。

  1. 对话示例
    1. 特征
      1. 媒体搜索
      2. 媒体请求
      3. 一体化
    2. 设置
      1. 先决条件
      2. 快速入门
    3. 技术细节
      1. 项目结构
      2. 可用工具
      3. 配置
      4. 错误处理
    4. 贡献
      1. 执照

        Related Resources

        Related MCP Servers

        • Needle MCP Serverofficial

          needle-ai
          A
          security
          A
          license
          A
          quality
          A server that allows users to manage documents and perform Claude-powered searches using Needle through the Claude Desktop application.
          Last updated -
          81
          MIT License
          • Apple

        • MCP Server for FTP Access

          alxspiker
          A
          security
          A
          license
          A
          quality
          Enables Claude to interact with FTP servers through natural language commands, allowing users to list directories, download/upload files, create directories, and delete files/directories on FTP servers.
          Last updated -
          6
          11
          MIT License
          • Linux
          • Apple

        • Inkeep MCP Serverofficial

          inkeep
          -
          security
          A
          license
          -
          quality
          A server that connects Claude to your documentation via Inkeep's API, enabling AI-powered interactions with your documentation content.
          Last updated -
          21
          MIT License
          • Apple
          • Linux

        • Readwise MCP Server

          IAmAlexander
          -
          security
          A
          license
          -
          quality
          Enables access and interaction with your Readwise library, allowing you to retrieve and search highlights, books, and documents through natural language queries when using Claude or other MCP-compatible assistants.
          Last updated -
          20
          MIT License

        View all related MCP servers

        Appeared in Searches

        New MCP Servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/jmagar/overseerr-mcp-server'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server