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.

Integrations

Provides access to your movie collection data, allowing querying, filtering, and retrieving detailed information about movies in your Radarr library by year, watched status, actors, and other criteria.
Provides access to your TV series and episode data, enabling querying, filtering, and retrieving detailed information about TV shows and episodes in your Sonarr library by various criteria including watched status and cast.

Radarr 和 Sonarr MCP 服务器

基于 Python 的模型上下文协议 (MCP) 服务器，为 Claude 等 AI 助手提供访问您的 Radarr（电影）和 Sonarr（电视剧）数据的权限。

概述

这款 MCP 服务器允许 AI 助手通过 Radarr 和 Sonarr API 查询您的电影和电视节目收藏。它基于 FastMCP 构建，实现了 Claude Desktop 和其他兼容 MCP 的客户端可以使用的 AI 上下文标准化协议。

特征

原生 MCP 实现：采用 FastMCP 构建，实现无缝 AI 集成
Radarr 集成：访问您的电影收藏
Sonarr 集成：访问您的电视节目和剧集数据
丰富的筛选功能：按年份、观看状态、演员等进行筛选
Claude Desktop 兼容：与 Claude 的 MCP 客户端无缝协作
轻松设置：交互式配置向导
经过充分测试：全面的可靠性测试套件

安装

来自源

克隆此存储库：
git clone https://github.com/yourusername/radarr-sonarr-mcp.git cd radarr-sonarr-mcp-python
安装软件包：
pip install -e .

使用 pip（即将推出）

pip install radarr-sonarr-mcp

快速入门

配置服务器：
radarr-sonarr-mcp configure
按照提示输入您的 Radarr/Sonarr API 密钥和其他设置。
启动服务器：
radarr-sonarr-mcp start
连接 Claude 桌面：
- 在 Claude Desktop 中，前往“设置”>“MCP 服务器”
- 添加一个新服务器，URL 为： http://localhost:3000 （或您配置的端口）

配置

配置向导将指导您完成设置：

NAS/服务器 IP 地址
Radarr API 密钥和端口
Sonarr API 密钥和端口
MCP 服务器端口

您也可以手动编辑config.json文件：

{
  "nasConfig": {
    "ip": "10.0.0.23",
    "port": "7878"
  },
  "radarrConfig": {
    "apiKey": "YOUR_RADARR_API_KEY",
    "basePath": "/api/v3",
    "port": "7878"
  },
  "sonarrConfig": {
    "apiKey": "YOUR_SONARR_API_KEY",
    "basePath": "/api/v3",
    "port": "8989"
  },
  "server": {
    "port": 3000
  }
}

可用的 MCP 工具

该服务器为Claude提供了以下工具：

电影

get_available_movies - 获取带有可选过滤器的电影列表
lookup_movie - 按标题搜索电影
get_movie_details - 获取特定电影的详细信息

系列

get_available_series - 获取带有可选过滤器的电视剧列表
lookup_series - 按标题搜索电视剧
get_series_details - 获取特定系列的详细信息
get_series_episodes - 获取特定系列的剧集

资源

服务器还提供标准 MCP 资源：

/movies浏览所有可观看的电影
/series - 浏览所有可观看的电视剧

过滤选项

大多数工具支持各种过滤选项：

year - 按发布年份过滤
watched - 按观看状态过滤（真/假）
downloaded - 按下载状态过滤（真/假）
watchlist - 按监视列表状态过滤（真/假）
actors - 按演员/演员阵容名称过滤
actresses - 按女演员姓名过滤（仅限电影）

Claude 的示例查询

一旦您的 MCP 服务器连接到 Claude Desktop，您可以提出以下问题：

“我有哪些 2023 年的科幻电影？”
“给我看看佩德罗·帕斯卡主演的电视节目”
“我还有未看的《曼达洛人》剧集吗？”
“查找我还没看过的汤姆·汉克斯主演的电影”
“我下载了多少集《怪奇物语》？”

查找 API 密钥

Radarr API 密钥

在浏览器中打开 Radarr
前往“设置”>“常规”
找到“API 密钥”部分
复制 API 密钥

Sonarr API 密钥

在浏览器中打开 Sonarr
前往“设置”>“常规”
找到“API 密钥”部分
复制 API 密钥

命令行界面

该软件包提供了一个命令行界面：

radarr-sonarr-mcp configure - 运行配置向导
radarr-sonarr-mcp start - 启动 MCP 服务器
radarr-sonarr-mcp status - 显示当前配置

发展

运行测试

运行测试套件：

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run tests with coverage
pytest --cov=radarr_sonarr_mcp

本地开发

为了快速开发和测试：

# Run directly without installation
python run.py

要求

Python 3.7+
FastMCP
请求
派丹蒂克

笔记

已关注/关注列表状态功能假设这些状态已使用 Radarr/Sonarr 中的特定机制进行跟踪。您可能需要根据具体设置进行调整。
出于安全原因，建议仅在本地网络上运行此服务器。

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

基于 Python 的模型上下文协议服务器，允许 Claude 等 AI 助手通过 Radarr 和 Sonarr API 访问和查询您的电影和电视节目集合。

Related Resources

Reddit Discussion about this server

Radarr and Sonarr MCP Server