servarr-mcp

一个用于 Servarr 套件（Sonarr、Radarr、Lidarr、Readarr 和 Prowlarr）的 MCP 服务器，打包为 Docker 容器。允许 MCP 客户端（如 Claude Desktop 等）浏览和搜索您正在运行的任何 *arr 应用。

应用是可选的：只需配置您实际运行的应用，系统将仅注册这些工具。

工具

Sonarr (电视节目)

工具	描述
`sonarr_list_series`	列出 Sonarr 追踪的所有电视节目
`sonarr_get_series`	按 ID 获取节目详情
`sonarr_lookup_series`	在 TVDB 中搜索要添加的新节目
`sonarr_list_episodes`	列出节目的剧集
`sonarr_calendar`	即将播出的剧集
`sonarr_queue`	当前下载队列
`sonarr_history`	最近历史记录（最新优先）

Radarr (电影)

工具	描述
`radarr_list_movies`	Radarr 追踪的所有电影
`radarr_get_movie`	按 ID 获取电影详情
`radarr_lookup_movie`	在 TMDB 中搜索要添加的新电影
`radarr_calendar`	即将上映的电影
`radarr_queue`	当前下载队列
`radarr_history`	最近历史记录（最新优先）

Lidarr (音乐)

工具	描述
`lidarr_list_artists`	Lidarr 追踪的所有艺术家
`lidarr_get_artist`	按 ID 获取艺术家详情
`lidarr_lookup_artist`	搜索要添加的新艺术家
`lidarr_list_albums`	列出专辑（可选按艺术家筛选）
`lidarr_queue`	当前下载队列
`lidarr_history`	最近历史记录

Readarr (书籍)

工具	描述
`readarr_list_authors`	Readarr 追踪的所有作者
`readarr_get_author`	按 ID 获取作者详情
`readarr_lookup_author`	搜索要添加的新作者
`readarr_list_books`	列出书籍（可选按作者筛选）
`readarr_queue`	当前下载队列
`readarr_history`	最近历史记录

Prowlarr (索引管理器)

工具	描述
`prowlarr_list_indexers`	所有已配置的索引器
`prowlarr_indexer_stats`	每个索引器的查询/抓取统计信息
`prowlarr_search`	在已启用的索引器中搜索
`prowlarr_history`	最近历史记录（查询、抓取）

配置

每个应用使用两个环境变量。设置这两个变量以启用该应用的工具；如果不设置，则跳过该应用。

应用	URL 变量	API 密钥变量	默认端口
Sonarr	`SONARR_URL`	`SONARR_API_KEY`	8989
Radarr	`RADARR_URL`	`RADARR_API_KEY`	7878
Lidarr	`LIDARR_URL`	`LIDARR_API_KEY`	8686
Readarr	`READARR_URL`	`READARR_API_KEY`	8787
Prowlarr	`PROWLARR_URL`	`PROWLARR_API_KEY`	9696

API 密钥可在每个应用的 设置 → 常规 → API 密钥 中找到。

必须至少配置一个应用，否则服务器将报错退出。

使用 Docker 运行

docker build -t servarr-mcp .
docker run -i --rm \
  -e SONARR_URL=http://192.168.1.50:8989 -e SONARR_API_KEY=... \
  -e RADARR_URL=http://192.168.1.50:7878 -e RADARR_API_KEY=... \
  -e PROWLARR_URL=http://192.168.1.50:9696 -e PROWLARR_API_KEY=... \
  servarr-mcp

与 Claude Desktop 一起使用

添加到您的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "servarr": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SONARR_URL", "-e", "SONARR_API_KEY",
        "-e", "RADARR_URL", "-e", "RADARR_API_KEY",
        "-e", "PROWLARR_URL", "-e", "PROWLARR_API_KEY",
        "servarr-mcp"
      ],
      "env": {
        "SONARR_URL": "http://192.168.1.50:8989",
        "SONARR_API_KEY": "...",
        "RADARR_URL": "http://192.168.1.50:7878",
        "RADARR_API_KEY": "...",
        "PROWLARR_URL": "http://192.168.1.50:9696",
        "PROWLARR_API_KEY": "..."
      }
    }
  }
}

针对您运行的任何应用重复 -e 和 env 块模式。

本地开发

npm install
cp .env.example .env  # then edit
SONARR_URL=... SONARR_API_KEY=... npm run dev

安全性

容器以非 root 用户 (servarr) 身份运行。
API 密钥通过环境变量传递 — 切勿将其硬编码到镜像中。
.githooks/pre-commit 会在每次提交时运行 gitleaks。每个克隆只需激活一次：git config core.hooksPath .githooks。

This server cannot be installed

F

license - not found

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

servarr-mcp

servarr-mcp

工具

Sonarr (电视节目)

Radarr (电影)

Lidarr (音乐)

Readarr (书籍)

Prowlarr (索引管理器)

配置

使用 Docker 运行

与 Claude Desktop 一起使用

本地开发

安全性

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API