Arr Suite MCP服务器
一个全面的模型上下文协议（MCP）服务器，为AI助手提供对整个arr套件媒体自动化堆栈的智能访问。
概述
Arr Suite MCP服务器是一个强大的集成，将Claude等人工智能助手连接到您的媒体自动化基础设施。它使用智能自然语言处理将请求自动路由到适当的服务，使媒体管理感觉自然直观。
支持服务列表
- 索纳尔 -电视剧管理
- 拉达尔 -电影管理
- Prowlarr -索引器管理和搜索
- 巴扎 -字幕管理
- 监督员 -媒体请求和发现
- 普乐 -媒体服务器管理和播放
- 夹克 -替代索引器代理（即将推出）
主要特点
- 🧠 智能意图识别：使用自然语言理解来自动确定使用哪个服务
- 🎯 统一接口：适用于所有arr服务的单个API
- 🔌 易于集成：简单的环境变量配置
- 🛡️ 类型安全：使用Pydantic构建，用于强大的验证
- ⚡ 异步优先：基于httpx构建，用于高性能异步操作
- 📝 全面的：API全面覆盖所有支持的服务
- 🎨 自然语言：像人一样与媒体服务器交谈
安装
来自PyPI（推荐）
pip install arr-suite-mcp来源
git clone https://github.com/shaktech786/arr-suite-mcp-server.git
cd arr-suite-mcp-server
pip install -e .快速开始
1.配置环境
创建一个 .env 文件：
# Sonarr Configuration
SONARR_HOST=localhost
SONARR_PORT=8989
SONARR_API_KEY=your_sonarr_api_key
# Radarr Configuration
RADARR_HOST=localhost
RADARR_PORT=7878
RADARR_API_KEY=your_radarr_api_key
# Prowlarr Configuration
PROWLARR_HOST=localhost
PROWLARR_PORT=9696
PROWLARR_API_KEY=your_prowlarr_api_key
# Bazarr Configuration
BAZARR_HOST=localhost
BAZARR_PORT=6767
BAZARR_API_KEY=your_bazarr_api_key
# Overseerr Configuration
OVERSEERR_HOST=localhost
OVERSEERR_PORT=5055
OVERSEERR_API_KEY=your_overseerr_api_key2.运行服务器
arr-suite-mcp3.配置克劳德桌面
添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：
{
"mcpServers": {
"arr-suite": {
"command": "arr-suite-mcp",
"env": {
"SONARR_HOST": "localhost",
"SONARR_PORT": "8989",
"SONARR_API_KEY": "your_api_key"
}
}
}
}用法示例
这个MCP服务器的美妙之处在于它的自然语言理解能力。以下是一些示例：
电视节目（Sonarr）
"Add Breaking Bad to my collection"
"Search for The Mandalorian"
"List all my TV shows"
"Get episodes for Game of Thrones season 8"
"Monitor The Office for new episodes"电影（拉达）
"Add The Matrix to my movies"
"Search for Inception"
"Show all my 4K movies"
"Get details for The Godfather"
"Find movies from 2023"索引器（Prowlarr）
"Search for Dune across all indexers"
"List all my indexers"
"Test all indexers"
"Sync indexers to Radarr and Sonarr"
"Show indexer statistics"字幕（巴扎）
"Download English subtitles for Dune"
"Search for Spanish subtitles for episode 3"
"Show movies missing subtitles"
"Get subtitle providers"请求（监督员）
"Request Avatar 2"
"Show pending requests"
"Approve request 123"
"Search for trending movies"
"Discover new TV shows"Plex 媒体服务器
"Search Plex for Breaking Bad"
"Show my Plex libraries"
"What's recently added to Plex?"
"Show what's playing on Plex"
"Get On Deck items"
"Scan my Movies library"
"Mark The Matrix as watched"高级操作
"Backup all Sonarr databases"
"Update quality profile in Radarr"
"Configure download client in Prowlarr"
"Get system status for all services"MCP工具
服务器提供高级智能工具和特定于服务的工具：
智能工具
arr_execute-使用自然语言执行任何arr操作arr_explain_intent-了解您的查询将如何被解释arr_list_services-显示已配置的服务arr_get_system_status-获取所有服务的健康状况
服务专用工具
每项服务都有专门的工具进行精确控制：
Sonarr工具
sonarr_search_series-搜索电视剧sonarr_add_series-添加新系列sonarr_get_series-获取全部或特定系列- 20多个操作
雷达工具
radarr_search_movie-搜索电影radarr_add_movie-添加新电影radarr_get_movies-获取所有或特定电影- 20多个操作
Prowlarr工具
prowlarr_search-跨索引器搜索prowlarr_get_indexers-列出所有索引器prowlarr_sync_apps-同步到应用程序- 还有15+次操作
Plex工具
plex_search-搜索Plex媒体plex_get_libraries-列出所有库plex_get_recently_added-最近添加的内容plex_get_sessions-目前正在玩plex_scan_library-扫描库以查找新内容plex_mark_watched-标记为已观看- 还有更多。..
配置
环境变量
服务器为每个服务使用带有前缀的环境变量：
# Format: {SERVICE}_{SETTING}
SONARR_HOST=localhost
SONARR_PORT=8989
SONARR_API_KEY=abc123
SONARR_SSL=false
# Global Settings
REQUEST_TIMEOUT=30
MAX_RETRIES=3
LOG_LEVEL=INFO查找API密钥
声纳/雷达
- 打开web UI
- 设置→ 将军
- 安全部分→ API密钥
Prowlarr
- 打开web UI
- 设置→ 将军
- 安全部分→ API密钥
巴扎
- 打开web UI
- 设置→ 将军
- 安全部分→ API密钥
监督员
- 打开web UI
- 设置→ 将军
- API关键部分
建筑
┌─────────────────────────────────────────┐
│ AI Assistant (Claude) │
└────────────────┬────────────────────────┘
│ MCP Protocol
┌────────────────▼────────────────────────┐
│ Arr Suite MCP Server │
│ ┌─────────────────────────────────┐ │
│ │ Intent Router (NLP) │ │
│ │ - Analyzes natural language │ │
│ │ - Determines service & action │ │
│ └─────────────┬───────────────────┘ │
│ │ │
│ ┌─────────────▼───────────────────┐ │
│ │ Service Clients │ │
│ │ ┌──────────┐ ┌──────────┐ │ │
│ │ │ Sonarr │ │ Radarr │ │ │
│ │ ├──────────┤ ├──────────┤ │ │
│ │ │ Prowlarr │ │ Bazarr │ │ │
│ │ ├──────────┤ ├──────────┤ │ │
│ │ │Overseerr │ │ More... │ │ │
│ │ └──────────┘ └──────────┘ │ │
│ └─────────────────────────────────┘ │
└────────────────┬────────────────────────┘
│ HTTP/REST APIs
┌────────────────▼────────────────────────┐
│ Your Arr Stack Services │
│ Sonarr│Radarr│Prowlarr│Bazarr│etc. │
└─────────────────────────────────────────┘数据库管理
服务器包括用于管理arr套件数据库的实用程序：
from arr_suite_mcp.utils.db_manager import ArrDatabaseManager
# Backup all databases
manager = ArrDatabaseManager(config_path="/path/to/arr/configs")
await manager.backup_all()
# Restore a database
await manager.restore("sonarr", "/path/to/backup.db")
# Execute SQL query
result = await manager.execute_query("sonarr", "SELECT * FROM Series")发展
运行测试
# Install dev dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Run with coverage
pytest --cov=arr_suite_mcp --cov-report=html代码质量
# Format code
black arr_suite_mcp
# Lint
ruff check arr_suite_mcp
# Type check
mypy arr_suite_mcpAPI覆盖范围
索纳尔
✅ 系列管理（添加、更新、删除、搜索） ✅ 事件管理 ✅ 质量配置 ✅ 根文件夹 ✅ 标签 ✅ 队列管理 ✅ 历史 ✅ 日历 ✅ 命令（刷新、重新扫描、重命名、备份） ✅ 配置
拉达尔
✅ 电影管理（添加、更新、删除、搜索） ✅ 集合 ✅ 质量配置 ✅ 根文件夹 ✅ 标签 ✅ 队列管理 ✅ 历史 ✅ 日历 ✅ 命令（刷新、重新扫描、重命名、备份） ✅ 配置 ✅ 导入列表 ✅ 通知
Prowlarr
✅ 索引器管理（添加、更新、删除、测试） ✅ 跨索引器搜索 ✅ 应用程序管理（Sonarr、Radarr连接） ✅ 标签 ✅ 历史 ✅ 统计 ✅ 下载客户端 ✅ 通知 ✅ 配置 ✅ 同步操作
巴扎
✅ 系列字幕管理 ✅ 电影字幕管理 ✅ 字幕搜索 ✅ 字幕下载 ✅ 历史 ✅ 语言 ✅ 提供商 ✅ 系统状态 ✅ 设置 ✅ 想要字幕 ✅ 黑名单
监督员
✅ 请求管理（创建、批准、拒绝） ✅ 媒体搜索 ✅ 探索（电影、电视） ✅ 热门内容 ✅ 用户管理 ✅ 设置（Plex、Radarr、Sonarr） ✅ 系统状态 ✅ 问题
故障排除
连接问题
# Test connectivity
curl http://localhost:8989/api/v3/system/status?apikey=YOUR_API_KEY
# Check logs
arr-suite-mcp --log-level DEBUG常见问题
- API密钥无效：双击web UI中的API键
- 连接被拒绝：确保服务正在运行且可访问
- SSL错误：设置
{SERVICE}_SSL=false用于本地部署
贡献
欢迎投稿！请看 贡献.md 作为指导方针。
许可证
MIT许可证-请参阅 许可证 了解详情。
致谢
支持
路线图
- \[\]夹克完全集成
- \[\]Lidarr支持（音乐）
- \[\]阅读支持（书籍）
- \[\]耳语支持（成人内容）
- \[\]高级过滤和排序
- \[\]批量操作
- \[\]自定义脚本集成
- \[\]WebSocket支持实时更新
- \[\]指标和监测
- \[\]多实例支持
______________________________________________________________________
由以下材料制成❤️ 面向媒体自动化社区