Overseerr MCP

基本能力

产品定位

Overseerr MCP 是一个媒体请求系统的自然语言交互接口，通过 Claude AI 实现与 Overseerr 的无缝集成。

核心功能

1. 媒体搜索
2. 搜索电影、电视节目和人物
3. 获取媒体详细信息（标题、上映日期、剧情概述、可用状态、请求状态）
4. 按媒体类型过滤（电影/电视/人物）

5. 支持自然语言查询

6. 媒体请求

7. 提交电影和电视节目请求
8. 指定电视节目的具体季节
9. 跟踪请求状态
10. 获取请求更新通知

11. 支持自然语言请求

12. 集成功能

13. 通过 stdio 传输与 Claude AI 无缝集成
14. 实时与 Overseerr 实例交互
15. 安全的 API 密钥处理
16. 速率限制和错误处理
17. 通过环境变量轻松配置

适用场景

• 通过自然语言搜索电影和电视节目
• 通过对话方式提交媒体请求
• 管理 Overseerr 实例

工具列表

1. 搜索媒体 (overseerr:search)
2. 功能：在 Overseerr 数据库中搜索电影、电视节目和人物

3. 示例查询：

   • "搜索《盗梦空间》"
   • "查找 2023 年的电视节目"
   • "寻找汤姆·汉克斯的电影"

4. 请求媒体 (overseerr:request)

5. 功能：请求将电影或电视节目添加到媒体库
6. 示例请求：
   • "请求《黑客帝国》"
   • "添加《办公室》第 1-3 季"
   • "请求《绝命毒师》全集"

常见问题解答

• 错误处理：服务器实现了稳健的错误处理，包括 API 错误消息、速率限制保护、请求验证和连接错误恢复。
• 配置：通过环境变量 OVERSEERR_URL 和 OVERSEERR_API_KEY 进行配置。

使用教程

使用依赖

1. 安装 Node.js
2. 安装 pnpm
3. 安装 Claude Desktop
4. 准备 Overseerr 实例

安装教程

1. 安装依赖：

pnpm install

1. 构建项目：

pnpm build

1. 配置环境：

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

# 编辑 .env 文件
OVERSEERR_URL=your_overseerr_url
OVERSEERR_API_KEY=your_api_key

1. 配置 Claude Desktop：
2. Linux/Mac：

{
  "overseerr": {
    "command": "node",
    "args": ["/path/to/overseerr/packages/server/dist/index.js"],
    "cwd": "/path/to/overseerr",
    "transport": {
      "type": "stdio"
    },
    "env": {
      "OVERSEERR_URL": "your_overseerr_url",
      "OVERSEERR_API_KEY": "your_api_key"
    }
  }
}

• Windows：

{
  "overseerr": {
    "command": "node",
    "args": ["C:\\path\\to\\overseerr\\packages\\server\\dist\\index.js"],
    "cwd": "C:\\path\\to\\overseerr",
    "transport": {
      "type": "stdio"
    },
    "env": {
      "OVERSEERR_URL": "your_overseerr_url",
      "OVERSEERR_API_KEY": "your_api_key"
    }
  }
}

1. 启动服务器：

pnpm start

调试方式

1. 确保所有依赖已正确安装
2. 检查环境变量配置是否正确
3. 验证 Claude Desktop 配置
4. 启动服务器后，尝试通过自然语言进行搜索和请求操作

许可证

该项目遵循 MIT 开源许可条款。