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 中，转到 Settings > MCP Servers
   • 添加一个新服务器，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 - 按观看状态过滤 (true/false)
• downloaded - 按下载状态过滤 (true/false)
• watchlist - 按愿望单状态过滤 (true/false)
• actors - 按演员/演员阵容姓名过滤
• actresses - 按女演员姓名过滤 (仅限电影)

Claude 的示例查询

将您的 MCP 服务器连接到 Claude Desktop 后，您可以提出如下问题:

• "我有哪些 2023 年的科幻电影?"
• "显示由 Pedro Pascal 主演的电视剧"
• "我是否有任何未观看的《曼达洛人》剧集?"
• "查找由汤姆·汉克斯主演但我尚未观看的电影"
• "我下载了多少集《怪奇物语》?"

查找 API 密钥

Radarr API 密钥

1. 在浏览器中打开 Radarr
2. 转到 Settings > General
3. 找到 "API Key" 部分
4. 复制 API 密钥

Sonarr API 密钥

1. 在浏览器中打开 Sonarr
2. 转到 Settings > General
3. 找到 "API Key" 部分
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 中的特定机制进行跟踪的。 您可能需要根据您的具体设置进行调整。
• 出于安全原因，建议仅在本地网络上运行此服务器。