🚀 🎬 YARR 媒体栈 MCP 服务器
YARR 媒体栈 MCP 服务器是一个全面的模型上下文协议（MCP）服务器，它能将大型语言模型（LLMs）与您自托管的媒体技术堆栈相连接。借助该项目，您不仅可以利用智能自动化和自然语言对媒体服务进行控制，还能保留传统的程序matic访问方式。
🚀 快速开始
本项目能让您轻松实现对媒体服务的智能控制和管理，下面将为您介绍具体的安装、配置和使用方法。
✨ 主要特性
- 🤖 支持基于 LLM 的自然语言控制媒体服务，让操作更加便捷。
- 🔌 采用模块化架构，方便进行功能扩展。
- 可通过 MCP 协议实现跨服务通信，增强系统的协同能力。
- 支持在多平台和设备上执行命令，具有广泛的适用性。
- 提供详细的日志记录和监控功能，便于系统的维护和管理。
📦 安装指南
安装依赖
执行以下命令安装所需依赖：
npm install @gotify/core @prowlarr/core @sonarr/core @overseerr/core mcp-server
创建 MCP 服务器配置文件 config.json
以下是配置文件的示例内容：
{
"services": {
"sonarr": {
"url": "http://localhost:8989",
"apiKey": "your_sonarr_api_key"
},
"prowlarr": {
"url": "http://localhost:9696",
"apiKey": "your_prowlarr_api_key"
},
"overseerr": {
"url": "http://localhost:5055",
"apiKey": "your_overseerr_api_key"
},
"gotify": {
"url": "http://localhost:8080",
"appToken": "your_gotify_app_token",
"clientToken": "your_gotify_client_token" # 可选，用于接收消息
}
},
"logging": {
"level": "info",
"outputPath": "./logs"
},
"monitoring": {
"enabled": true,
"interval": 60000
}
}
💻 使用示例
基础用法
Sonarr 操作
// 系列管理
sonarr:search - 在所有索引器中搜索电视剧
sonarr:list-series - 列出所有监控的电视剧
sonarr:series-details - 获取特定电视剧的详细信息
sonarr:add-series - 添加新的电视剧到监控列表
sonarr:monitor-season - 监控或取消监控某一季
sonarr:list-profiles - 列出质量与语言配置文件
sonarr:upcoming - 获取即将上映的剧集
sonarr:queue - 查看当前下载队列
sonarr:remove-from-queue - 从队列中移除某个项目
Prowlarr 操作
prowlarr:search - 在所有索引器中搜索
prowlarr:list-indexers - 列出配置的索引器
prowlarr:indexer-stats - 获取索引器性能统计信息
prowlarr:check-config - 验证 Prowlarr 连接状态
Overseerr 操作
overseerr:search - 搜索电影和电视剧
overseerr:request - 请求一部电影或电视剧
overseerr:list-requests - 列出所有媒体请求
overseerr:update-request - 更新某个请求的状态
overseerr:trending - 获取热门媒体及其推荐
overseerr:available - 获取流行且可获得的媒体
overseerr:status - 获取系统状态
Gotify 操作
gotify:messages:list - 分页列出消息
gotify:messages:send - 发送新消息
gotify:messages:delete - 根据 ID 删除消息
gotify:messages:cleanup - 删除旧消息
gotify:apps:list - 列出所有应用
gotify:apps:create - 创建新的应用
gotify:clients:list - 列出所有客户端
gotify:clients:create - 创建新的客户端
gotify:health - 检查 Gotify 服务器健康状态
gotify:stats - 获取 Gotify 统计信息
通过以上命令，您可以方便地控制和管理您的媒体服务，实现自动化的工作流程。