麦克帕尔
用于\*arr媒体自动化堆栈的统一MCP服务器。
在5个服务中提供19个面向动作的工具，用于通过以下方式管理媒体获取、下载和字幕 模型上下文协议.
服务
| 服务 | 工具 | 功能 |
|---|---|---|
| 索纳尔 | 5 | 电视剧--搜索、添加、排队、日历 |
| 拉达尔 | 5 | 电影--搜索、添加、排队、日历 |
| SABnzbd | 4 | 下载--队列、历史记录、暂停/恢复 |
| Prowlarr | 2 | 索引器——搜索、统计 |
| 巴扎 | 2 | 字幕--需要，搜索 |
| 系统 | 1 | 所有服务的运行状况和版本信息 |
缺少配置的服务会被优雅地禁用——只有配置好的工具才会出现在工具列表中。
快速开始
# Clone and install
git clone https://github.com/cameronsjo/mcparr.git
cd mcparr
uv sync
# Configure (copy and fill in API keys)
cp .env.example .env
# Run
uv run python -m mcparr服务器启动于 http://0.0.0.0:8080/mcp （流式HTTP传输）。
配置
所有配置均通过环境变量进行 MCPARR_ 前缀：
# Server
MCPARR_HOST=0.0.0.0
MCPARR_PORT=8080
MCPARR_PATH=/mcp
MCPARR_LOG_LEVEL=info
# Services (empty URL = disabled)
MCPARR_SONARR_URL=http://sonarr:8989
MCPARR_SONARR_API_KEY=your-api-key
MCPARR_RADARR_URL=http://radarr:7878
MCPARR_RADARR_API_KEY=your-api-key
MCPARR_PROWLARR_URL=http://prowlarr:9696
MCPARR_PROWLARR_API_KEY=your-api-key
MCPARR_SABNZBD_URL=http://sabnzbd:8080
MCPARR_SABNZBD_API_KEY=your-api-key
MCPARR_BAZARR_URL=http://bazarr:6767
MCPARR_BAZARR_API_KEY=your-api-key码头工人
# Build
docker build -t mcparr .
# Run
docker run --env-file .env -p 8080:8080 mcparr预构建图像： ghcr.io/cameronsjo/mcparr:latest
工具
电影（拉达）
- search_movies --搜索库或按标题查找新电影
- get_movie --按ID获取特定电影的详细信息
- add_movie --将电影添加到Radarr进行监控和下载
- get_movie_queue --获取电影下载队列的进度
- get_movie_calendar --获取即将上映的电影
电视节目（Sonarr）
- 搜索系列 --搜索库或按标题查找新的电视剧
- get_series --获取特定系列的详细信息，包括季节细分
- add_series --在Sonarr中添加一系列用于监控和下载
- get_series队列 --获取电视节目下载队列及其进度
- get_series_calendar --获取即将播出的剧集日期
下载（SABnzbd）
- get_downloads --当前下载队列，包括速度、进度、预计到达时间
- get_download_历史 --已完成的下载历史记录
- pause_downloads --暂停下载队列（可选N分钟）
- resume_下载 --恢复下载队列
索引器（Prowlarr）
- search_indexers --在所有已配置的索引器中搜索
- get_index_stats --索引器性能统计
字幕（巴扎）
- 获取字幕 --电影和剧集缺少字幕
- 搜索子标题 --触发电影或剧集的字幕搜索
系统
- get_system_status --所有已配置服务的运行状况和版本信息
发展
make check # Lint + typecheck
make fix # Auto-fix lint issues
make test # Run tests
make dev # Start dev server许可证
麻省理工学院