AI导哈

媒体库管理MCP服务器

一个基于Python的MCP服务器，为AI助手提供对Radarr（电影）和Sonarr（电视剧）数据的访问。

  • by BerryKuipers
  • Python
  • 本地部署
  • 47 星标
  • 更新于
在 GitHub 查看 BerryKuipers/mcp_services_radarr_sonarr

使用说明

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的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中，转到“设置”>“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年的科幻电影有哪些？”
  • “给我看佩德罗·帕斯卡主演的电视节目”
  • “我有《曼达洛人》的未观看剧集吗？”
  • “找到我还没看过的汤姆·汉克斯的电影”
  • “我下载了多少集《怪奇物语》？”

查找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
  • 请求：
  • 派丹蒂克

备注

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

相关 MCP