🚀 Overseerr 管理控制台协议 (MCP)
Overseerr 管理控制台协议 (MCP) 集成于 Overseerr 之中，借助 Claude AI，让您能够以自然语言与媒体请求系统进行交互。通过该服务器，您可以使用对话式语言搜索电影和电视剧、提交媒体请求，还能管理 Overseerr 实例。
🚀 快速开始
先决条件
- Node.js
- pnpm
- Claude Desktop
- Overseerr 实例
安装步骤
- 安装依赖：
pnpm install
- 构建项目：
pnpm build
- 配置环境：
# 复制模板
cp .env.template .env
# 用你的值编辑 .env
OVERSEERR_URL=your_overseerr_url
OVERSEERR_API_KEY=your_api_key
- 启动服务器：
pnpm start
💻 使用示例
示例对话
以下是您可以与 Claude 使用此服务器进行的一些示例对话：
你: 你能找到任何近期的科幻电影吗？
Claude: 让我搜索一下最近的科幻电影...
[使用 overseerr:search 查找近期的科幻电影]
你: 这个看起来不错！你可以请求第二部吗？
Claude: 我将为您请求该电影...
[使用 overseerr:request 提交媒体请求]
你: 关于烹饪的电视剧有哪些可用？
Claude: 我将搜索与烹饪相关的电视剧...
[使用 overseerr:search 和 type='tv' 查找烹饪类剧集]
✨ 主要特性
媒体搜索
- 在电影、电视剧和人中进行搜索。
- 获取有关媒体的详细信息，包括：
- 标题和发行日期。
- 剧情概述。
- 可用性状态。
- 请求状态。
- 按媒体类型（电影/电视剧/人）筛选。
- 支持自然语言查询（例如，“查找近期的科幻电影”或“搜索像《断裂点》那样的剧集”）。
媒体请求
- 可请求电影和电视剧。
- 能为电视剧指定具体赛季。
- 可跟踪请求状态。
- 能获取有关请求更新的通知。
- 支持自然语言请求（例如，“请求最新的蝙蝠侠电影”或“将《Succession》添加到我的观看列表中”）。
集成
- 通过 stdio 运输实现无缝的 Claude AI 集成。
- 可实时与您的 Overseerr 实例交互。
- 具备安全的 API 密钥处理机制。
- 有速率限制和错误处理功能。
- 可通过环境变量进行简单配置。
🔧 技术细节
环境变量
OVERSEERR_URL：您的 Overseerr 实例 URL。OVERSEERR_API_KEY：您的 Overseerr API 密钥。
错误处理
服务器实现了强大的错误处理机制：
- 具有有意义消息的 API 错误处理。
- 速率限制保护。
- 请求验证。
- 连接错误恢复。
🤝 贡献指南
- 叉取仓库。
- 创建功能分支。
- 提交你的更改。
- 推送到分支。
- 创建 Pull Request。
📄 许可证
MIT