FindMCP Logo FindMCP.info
Radarr and Sonarr MCP Server

Radarr and Sonarr MCP Server

site icon
2025.03.03 5
Python媒体管理AI集成娱乐功能
Radarr and Sonarr MCP Server 是一个基于Python的模型上下文协议（MCP）服务器，旨在为AI助手（如Claude）提供访问Radarr（电影）和Sonarr（电视剧）数据的能力。该服务器允许AI助手通过Radarr和Sonarr的API查询用户的电影和电视剧集，支持丰富的过滤功能，如按年份、观看状态、演员等进行筛选。
View on GitHub

Overview

基本能力

产品定位

Radarr and Sonarr MCP Server 是一个连接AI助手与个人媒体库的桥梁，通过标准化的MCP协议，使得AI助手能够查询和管理用户的电影和电视剧集。

核心功能

  • Native MCP Implementation: 使用FastMCP构建，实现无缝的AI集成。
  • Radarr Integration: 访问和管理电影收藏。
  • Sonarr Integration: 访问和管理电视剧集数据。
  • Rich Filtering: 支持按年份、观看状态、演员等多种条件筛选。
  • Claude Desktop Compatible: 与Claude的MCP客户端无缝协作。
  • Easy Setup: 提供交互式配置向导。
  • Well-tested: 拥有全面的测试套件，确保可靠性。

适用场景

  • 查询个人媒体库中的电影和电视剧集。
  • 通过AI助手快速找到特定条件的媒体内容（如未观看的科幻电影）。
  • 管理媒体库的观看状态和下载状态。

工具列表

  • Movies:
  • get_available_movies: 获取电影列表，支持多种过滤条件。
  • lookup_movie: 按标题搜索电影。
  • get_movie_details: 获取特定电影的详细信息。
  • Series:
  • get_available_series: 获取电视剧列表，支持多种过滤条件。
  • lookup_series: 按标题搜索电视剧。
  • get_series_details: 获取特定电视剧的详细信息。
  • get_series_episodes: 获取特定电视剧的剧集列表。

常见问题解答

  • 如何获取Radarr和Sonarr的API密钥？
  • Radarr: 在浏览器中打开Radarr，进入Settings > General，找到"API Key"部分并复制。
  • Sonarr: 在浏览器中打开Sonarr，进入Settings > General，找到"API Key"部分并复制。
  • 如何配置服务器？
  • 运行radarr-sonarr-mcp configure命令，按照提示输入Radarr/Sonarr的API密钥和其他设置。

使用教程

使用依赖

  • Python 3.7+
  • FastMCP
  • Requests
  • Pydantic

安装教程

  1. 克隆仓库： bash git clone https://github.com/yourusername/radarr-sonarr-mcp.git cd radarr-sonarr-mcp-python
  2. 安装包： bash pip install -e .

快速开始

  1. 配置服务器： bash radarr-sonarr-mcp configure
  2. 启动服务器： bash radarr-sonarr-mcp start
  3. 连接Claude Desktop：
  4. 在Claude Desktop中，进入Settings > MCP Servers。
  5. 添加新服务器，URL为http://localhost:3000（或配置的端口）。

调试方式

  • 运行测试： bash pip install -e ".[dev]" pytest
  • 直接运行开发版本： bash python run.py

许可证

None