项目简介

Overseerr MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在连接 Anthropic 的 Claude 模型与 Overseerr 媒体管理工具。通过此服务器，用户可以使用 Claude 与 Overseerr 实例进行交互，实现媒体内容的搜索、详细信息查询、请求添加到个人媒体库以及查看和管理现有请求等功能。

主要功能点

媒体搜索: 允许 Claude 搜索电影和电视剧，以便用户发现 Overseerr 支持的媒体内容。
媒体详情查询: 提供工具以获取特定电影或电视剧的详细信息，帮助用户在请求前了解更多内容。
媒体请求: 用户可以通过 Claude 直接请求将电影或电视剧添加到其个人媒体库中，简化媒体添加流程。
请求管理: 支持查看和管理已有的媒体请求，方便用户跟踪和管理其请求状态。

安装步骤

准备工作: 确保你的电脑上已安装 Node.js 和 npm (或 yarn)。

下载代码: 克隆 GitHub 仓库到本地：

git clone https://github.com/jmagar/overseerr-mcp-server.git
cd overseerr-mcp-server

安装依赖: 在项目根目录下运行以下命令安装项目依赖：
```
npm install
```
构建服务器: 运行以下命令编译 TypeScript 代码并生成可执行的 JavaScript 文件：
```
npm run build
```

配置环境变量: 在项目根目录下创建 '.env' 文件，并填入以下 Overseerr 实例的配置信息：

OVERSEERR_URL=http://your-overseerr-instance:5055  # 替换为你的 Overseerr 实例 URL，例如 http://localhost:5055
OVERSEERR_API_KEY=your_api_key_here             # 替换为你的 Overseerr API 密钥 (在 Overseerr 设置中获取)

请确保 Overseerr 实例已运行并且 API 密钥配置正确。

服务器配置 (Claude Desktop)

要将此 MCP 服务器配置到 Claude Desktop 客户端，你需要编辑 Claude Desktop 的配置文件。根据你的操作系统，配置文件路径如下：

MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

打开 'claude_desktop_config.json' 文件，在 'mcpServers' 字段中添加以下配置信息。如果 'mcpServers' 字段不存在，请手动创建。

{
  "mcpServers": {
    "overseerr-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/overseerr-mcp-server/dist/index.js"]
    }
  }
}

配置参数说明:

'"overseerr-mcp-server"': 服务器名称，可以自定义，用于在 Claude Desktop 中标识该服务器。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 运行时环境。
'"args": ["/absolute/path/to/overseerr-mcp-server/dist/index.js"]': 启动命令的参数，指向服务器入口文件 'dist/index.js' 的绝对路径。你需要将 '/absolute/path/to/overseerr-mcp-server' 替换为你本地 Overseerr MCP Server 项目的绝对路径。

注意: 请务必使用服务器入口文件 'dist/index.js' 的绝对路径。

基本使用方法

配置完成后，你可以在 Claude 中通过自然语言指令来使用这些工具。以下是一些示例：

搜索电影: "使用 'search_media' 工具搜索克里斯托弗·诺兰的电影"
查询电影详情: "展示电影《盗梦空间》的详细信息"
请求电视剧: "请求电视剧《怪奇物语》"
查看请求: "显示我待处理的媒体请求"

可用的工具及其功能已在仓库的 README.md 文件中列出。在与 Claude 对话时，你可以明确指示 Claude 使用特定的工具来完成相应的操作。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (Claude Desktop)

基本使用方法

信息