FastMCP server for Overseerr

Seerr 的 FastMCP 服务

使用 fastmcp 库构建的 FastMCP 服务，用于与 Seerr API 交互，管理电影和电视剧请求。

项目仓库：https://github.com/ptbsare/seerr-mcp-server

组件

工具

该服务实现了以下工具，用于与 Seerr 交互：

• seerr_status：获取 Seerr 服务的状态。
• seerr_movie_requests：获取分页的电影请求列表。接受可选参数 status、start_date（格式为 YYYY-MM-DDTHH:MM:SS.mmmZ）、take（默认值为 7）和 skip（默认值为 0）。
• seerr_tv_requests：获取分页的电视剧请求列表。接受可选参数 status、start_date（格式为 YYYY-MM-DDTHH:MM:SS.mmmZ）、take（默认值为 7）和 skip（默认值为 0）。
• seerr_request_movie_to_library：使用 TMDB ID，代表特定用户向指定媒体库提交电影请求。需要 tmdb_id、library_name 和 user_display_name。可用的媒体库名称和用户显示名称（仅包含不重复的名称）会在服务启动时获取，并包含在工具的参数说明中。
• seerr_request_tv_to_library：使用 TMDB ID，代表特定用户向指定媒体库提交电视剧请求。需要 tmdb_id、library_name 和 user_display_name。可选接受 seasons（整数列表）。可用的媒体库名称和用户显示名称（仅包含不重复的名称）会在服务启动时获取，并包含在工具的参数说明中。
• seerr_search_media：搜索 Seerr 上可用的电影和电视剧。接受 query 和可选参数 page（默认值为 1）。
• seerr_get_available_libraries：从 Seerr 获取已配置的 Sonarr（电视剧）和 Radarr（电影）服务 ID 及名称。
• seerr_get_users：获取 Seerr 中所有已配置用户的列表，包括其 ID、用户名、电子邮件、显示名称等。

示例提示词

建议先指示 AI 助手（例如 Claude）使用 Seerr 工具。之后，它便可根据需要调用相应的工具。

可以尝试以下提示词：

• 获取我们的 Seerr 服务状态。
• 显示当前待处理的前 5 个电影请求。
• 列出所有自 2024-01-01 起提交且现已可用的电视剧请求。
• 有哪些电影已被请求但尚不可用？
• 最近有哪些电视剧已在我们的媒体库中上线？
• 在 Seerr 上搜索电影《沙丘：第二部》。
• Seerr 中配置了哪些电影和电视剧媒体库？
• 列出 Seerr 中的所有用户。
• 在“Movies HD”媒体库中，为用户“John Doe”请求 TMDB ID 为 693134 的电影。（使用 user_display_name='John Doe'、library_name='Movies HD'）
• 在“TV Shows 4K”媒体库中，为用户“Jane Smith”请求 TMDB ID 为 1396 的电视剧第 1 和第 2 季。（使用 user_display_name='Jane Smith'）

快速开始

前置条件

• uv（安装说明：https://github.com/astral-sh/uv）
• 正在运行的 Seerr 实例。
• Seerr 实例的 API 密钥（设置 → API 密钥）。

使用 uvx 运行（推荐——无需安装）

你可以直接从 git 仓库运行服务，无需克隆或安装：

uvx --from git+https://github.com/ptbsare/seerr-mcp-server.git seerr-mcp-server

Claude Desktop 配置

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "seerr-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/ptbsare/seerr-mcp-server.git",
        "seerr-mcp-server"
      ],
      "env": {
        "SEERR_API_KEY": "<your_api_key_here>",
        "SEERR_URL": "<your_seerr_url>"
      }
    }
  }
}

将 <your_api_key_here> 和 <your_seerr_url> 替换为你实际的 Seerr API 密钥和 URL。

环境变量

需要设置以下环境变量：

• SEERR_API_KEY：你的 Seerr API 密钥（可在 Seerr 设置 → API 密钥中找到）
• SEERR_URL：Seerr 实例的 URL（例如，http://localhost:5055）

对于 Claude Desktop 等客户端，请按上文所示将这些变量添加到 env 字段。本地使用时，可以导出这些变量，也可以使用 .env 文件：

SEERR_API_KEY=your_api_key_here
SEERR_URL=http://localhost:5055

本地开发安装

如果你希望在本地安装以进行开发：

git clone https://github.com/ptbsare/seerr-mcp-server.git
cd seerr-mcp-server
uv venv
source .venv/bin/activate # On Windows use `.venv\Scripts\activate`
uv pip install -e .

开发

安装

按照安装步骤，使用 uv pip install -e . 进行可编辑安装。

依赖项

使用 uv 安装或同步依赖项：

uv sync
# or
uv pip install -e .

调试

由于 MCP 服务通过 stdio 运行，调试可能颇具挑战。

• MCP Inspector： 强烈推荐使用 MCP Inspector。

  启动时指定你的服务脚本：

  # 使用 uvx（无需本地安装）
  npx @modelcontextprotocol/inspector uvx --from git+https://github.com/ptbsare/seerr-mcp-server.git seerr-mcp-server
  
  # 或使用 uv run（在本地项目目录中）
  npx @modelcontextprotocol/inspector uv run seerr-mcp-server
  

  在浏览器中访问 Inspector 提供的 URL。

• 日志记录： 服务会将基本信息记录到 stdout/stderr。检查运行 uv run seerr-mcp-server 的终端。对于 Claude Desktop 等客户端，请查看客户端的日志文件（例如，macOS 上的 ~/Library/Logs/Claude/mcp-server-seerr-mcp.log，但名称可能因配置而异）。

许可证

MIT