overseerr-mcp-server

🚀 Overseerr 管理控制台协议 (MCP)

Overseerr 管理控制台协议 (MCP) 集成于 Overseerr 之中，借助 Claude AI，让您能够以自然语言与媒体请求系统进行交互。通过该服务器，您可以使用对话式语言搜索电影和电视剧、提交媒体请求，还能管理 Overseerr 实例。

🚀 快速开始

先决条件

• Node.js
• pnpm
• Claude Desktop
• Overseerr 实例

安装步骤

1. 安装依赖：

pnpm install

2. 构建项目：

pnpm build

3. 配置环境：

# 复制模板
cp .env.template .env

# 用你的值编辑 .env
OVERSEERR_URL=your_overseerr_url
OVERSEERR_API_KEY=your_api_key

4. 启动服务器：

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 错误处理。
• 速率限制保护。
• 请求验证。
• 连接错误恢复。

🤝 贡献指南

1. 叉取仓库。
2. 创建功能分支。
3. 提交你的更改。
4. 推送到分支。
5. 创建 Pull Request。

📄 许可证

MIT