Radarr 和 Sonarr MCP 服务器

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

概述

这个 MCP 服务器允许 AI 助手通过 Radarr 和 Sonarr API 查询您的电影和电视剧集。它使用 FastMCP 构建，实现了 Claude Desktop 和其他兼容 MCP 的客户端可以使用的标准化协议。

特性

• 原生 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 - 按观看状态过滤（true/false）
• downloaded - 按下载状态过滤（true/false）
• watchlist - 按观看列表状态过滤（true/false）
• actors - 按演员/演员表名称过滤
• actresses - 按女演员名称过滤（仅限电影）

Claude 示例查询

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

• "我有哪些2023年的科幻电影？"
• "显示由佩德罗·帕斯卡主演的电视剧"
• "《曼达洛人》中我有没有未观看的剧集？"
• "找到我还没有观看过的汤姆·汉克斯出演的电影"
• "我下载了多少集《怪奇物语》？"

寻找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 - 显示当前配置

开发

运行测试

要运行测试套件：

# 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
• Requests
• Pydantic

注意事项

• 观看/待看状态功能假设这些是通过Radarr/Sonarr中的特定机制跟踪的。你可能需要根据你的具体设置进行调整。
• 出于安全考虑，建议仅在本地网络上运行此服务器。