用于 Overseerr 的 MCP 服务器

用于与 Overseerr API 交互以进行电影和电视节目请求管理的 MCP 服务器。

<!-- 发布后将添加徽章 -->

组件

工具

该服务器实现了多个工具来与 Overseerr 交互：

• overseerr_status：获取 Overseerr 服务器的状态
• overseerr_movie_requests：获取满足过滤参数的所有电影请求的列表
• overseerr_tv_requests：获取满足过滤参数的所有电视节目请求的列表

示例提示

最好首先指示 Claude 使用 Overseerr。 这样，它总会在适当的时候调用该工具。

尝试以下提示：

• 获取我们的 Overseerr 服务器的状态
• 显示我所有当前待处理的电影请求
• 列出上个月至今所有可用的电视节目请求
• 有哪些电影已被请求但尚未可用？
• 我们的媒体库中最近有哪些电视节目可用？

配置

Overseerr API 密钥和 URL

有两种方法可以使用 Overseerr API 凭据配置环境：

1. 添加到服务器配置（首选）

{
  "overseerr-mcp": {
    "command": "uvx",
    "args": [
      "overseerr-mcp"
    ],
    "env": {
      "OVERSEERR_API_KEY": "<your_api_key_here>",
      "OVERSEERR_URL": "<your_overseerr_url>"
    }
  }
}

2. 在工作目录中创建一个包含以下必需变量的 .env 文件：

OVERSEERR_API_KEY=your_api_key_here
OVERSEERR_URL=your_overseerr_url_here

注意：您可以在 Overseerr 设置中的“API 密钥”下找到 API 密钥。

快速入门

安装

Overseerr API 密钥

您需要一个正在运行的 Overseerr 实例和一个 API 密钥：

1. 导航到您的 Overseerr 安装
2. 转到设置 → 常规
3. 找到“API 密钥”部分
4. 如果您还没有 API 密钥，请生成一个新的 API 密钥

Claude Desktop

在 MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json

在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

<details> <summary>开发/未发布的服务器配置</summary>

{
  "mcpServers": {
    "overseerr-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/overseerr-mcp",
        "run",
        "overseerr-mcp"
      ],
      "env": {
        "OVERSEERR_API_KEY": "<your_api_key_here>",
        "OVERSEERR_URL": "<your_overseerr_url>"
      }
    }
  }
}

</details>

注意：此 MCP 服务器尚未发布。 目前，只有开发配置可用。

开发

构建

要准备用于分发的软件包：

1. 同步依赖项并更新锁定文件：

uv sync

调试

由于 MCP 服务器通过 stdio 运行，因此调试可能具有挑战性。 为了获得最佳的调试体验，我们强烈建议使用 MCP Inspector。

您可以使用以下命令通过 npm 启动 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory /path/to/overseerr-mcp run overseerr-mcp

启动后，Inspector 将显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。

您还可以使用以下命令查看服务器日志：

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-overseerr-mcp.log

许可证

MIT