星战科技xingzhan.cloud
返回市场
MCP服务RadarrSonarr

MCP服务RadarrSonarr

作者：BerryKuipers18 星标更新：2025-10-25
安装使用来源：spider==github.com

项目介绍

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客户端无缝工作
  • 简单设置：交互式配置向导
  • 经过充分测试：全面的测试套件以确保可靠性

安装

从源码安装

  1. 克隆此仓库：

    git clone https://github.com/yourusername/radarr-sonarr-mcp.git
cd radarr--sonarr-mcp-python

  2. 安装包：

    pip install -e .

使用pip安装（即将推出）

pip install radarr-sonarr-mcp

快速开始

  1. 配置服务器：

    radarr-sonarr-mcp configure

    按照提示输入您的Radarr/Sonarr API密钥和其他设置。

  2. 启动服务器：

    radarr-sonarr-mcp start

  3. 连接Claude Desktop：

    • 在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年的科幻电影？"
  • "给我看Pedro Pascal主演的电视剧"
  • "我有未观看的《曼达洛人》剧集吗？"
  • "找到我尚未观看的Tom Hanks主演的电影"
  • "我已经下载了多少集《怪奇物语》？"

查找API密钥

Radarr API密钥

  1. 在浏览器中打开Radarr
  2. 前往设置 > 通用
  3. 找到“API密钥”部分
  4. 复制API密钥

Sonarr API密钥

  1. 在浏览器中打开Sonarr
  2. 前往设置 > 通用
  3. 找到“API密钥”部分
  4. 复制API密钥

命令行界面

该包提供了一个命令行接口：

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

开发

运行测试

要运行测试套件：

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
pytest

# 运行带有覆盖率的测试
pytest --cov=radarr_sonarr_mcp

本地开发

快速开发和测试：

# 直接运行而不安装
python run.py

要求

  • Python 3.7+
  • FastMCP
  • Requests
  • Pydantic

注意事项

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