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客户端无缝协作
- 轻松设置：交互式配置向导
- 经过充分测试：可靠性综合测试套件
安装
来源
- 克隆此存储库：
git clone https://github.com/yourusername/radarr-sonarr-mcp.git
cd radarr-sonarr-mcp-python- 安装软件包：
pip install -e .使用pip（即将推出）
pip install radarr-sonarr-mcp快速开始
- 配置服务器：
radarr-sonarr-mcp configure按照提示输入Radarr/Sonarr API键和其他设置。
- 启动服务器：
radarr-sonarr-mcp start- 连接克劳德桌面：
- 在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密钥
- 在浏览器中打开Radarr
- 前往“设置”>“常规”
- 查找“API密钥”部分
- 复制API密钥
Sonarr API密钥
- 在浏览器中打开Sonarr
- 前往“设置”>“常规”
- 查找“API密钥”部分
- 复制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中的特定机制进行跟踪的。您可能需要根据您的具体设置进行调整。
- 出于安全原因，建议仅在本地网络上运行此服务器。