Radarr 和 Sonarr MCP 服务器
基于 Python 的模型上下文协议 (MCP) 服务器，为 Claude 等 AI 助手提供访问您的 Radarr（电影）和 Sonarr（电视剧）数据的权限。
概述
这款 MCP 服务器允许 AI 助手通过 Radarr 和 Sonarr API 查询您的电影和电视节目收藏。它基于 FastMCP 构建，实现了 Claude Desktop 和其他兼容 MCP 的客户端可以使用的 AI 上下文标准化协议。
Related MCP server: Aider MCP Server
特征
原生 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（即将推出）
快速入门
配置服务器：
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文件：
可用的 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- 显示当前配置
发展
运行测试
运行测试套件：
本地开发
为了快速开发和测试：
要求
Python 3.7+
FastMCP
请求
派丹蒂克
笔记
已关注/关注列表状态功能假设这些状态已使用 Radarr/Sonarr 中的特定机制进行跟踪。您可能需要根据具体设置进行调整。
出于安全原因，建议仅在本地网络上运行此服务器。