jgarciaga
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"overseerr-mcp": {
"args": [
"--directory",
"\u003cdir_to\u003e/overseerr-mcp",
"run",
"overseerr-mcp"
],
"command": "uv",
"env": {
"OVERSEERR_API_KEY": "\u003cyour_api_key_here\u003e",
"OVERSEERR_URL": "\u003cyour_overseerr_url\u003e"
}
}
}
}服务介绍
MCP 服务器用于 Overseerr
MCP 服务器用于与 Overseerr API 交互，以管理电影和电视剧的请求。
组件
工具
该服务器实现了多个工具来与 Overseerr 交互：
overseerr_status：获取 Overseerr 服务器的状态overseerr_movie_requests：获取满足过滤条件的所有电影请求列表overseerr_tv_requests：获取满足过滤条件的所有电视剧请求列表
示例提示
首先指示 Claude 使用 Overseerr 是个好主意。这样它会在适当的时候调用工具。
尝试以下提示：
- 获取我们的 Overseerr 服务器状态
- 显示所有当前待处理的电影请求
- 列出上个月提出且现在可用的所有电视剧请求
- 哪些电影已被请求但尚未可用？
- 最近有哪些电视剧在我们的库中变得可用？
配置
Overseerr API 密钥 & URL
有两种方法可以使用 Overseerr API 凭证配置环境：
- 添加到服务器配置（推荐）
json
{
"overseerr-mcp": {
"command": "uvx",
"args": [
"overseerr-mcp"
],
"env": {
"OVERSEERR_API_KEY": "<your_api_key_here>",
"OVERSEERR_URL": "<your_overseerr_url>"
}
}
}
- 在工作目录中创建一个
.env文件，并包含以下必需变量：
OVERSEERR_API_KEY=your_api_key_here
OVERSEERR_URL=your_overseerr_url_here
注意：您可以在 Overseerr 设置中的“API Keys”部分找到 API 密钥。
快速开始
安装
Overseerr API 密钥
您需要运行一个 Overseerr 实例并拥有一个 API 密钥：
- 转到您的 Overseerr 安装
- 进入设置 → 通用
- 找到“API Key”部分
- 如果还没有 API 密钥，请生成一个新的
Claude 桌面版
在 MacOS 上: ~/Library/Application Support/Claude/claude_desktop_config.json
在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json
json
{
"mcpServers": {
"overseerr-mcp": {
"command": "uv",
"args": [
"--directory",
"<dir_to>/overseerr-mcp",
"run",
"overseerr-mcp"
],
"env": {
"OVERSEERR_API_KEY": "<your_api_key_here>",
"OVERSEERR_URL": "<your_overseerr_url>"
}
}
}
}
注意：此 MCP 服务器尚未发布。目前只有开发配置可用。
开发
构建
准备分发包：
- 同步依赖项并更新锁文件：
bash
uv sync
调试
由于 MCP 服务器通过 stdio 运行，调试可能会很困难。为了获得最佳调试体验，我们强烈建议使用 MCP Inspector。
您可以使用以下命令通过 npm 启动 MCP Inspector：
bash
npx @modelcontextprotocol/inspector uv --directory /path/to/overseerr-mcp run overseerr-mcp
启动后，Inspector 将显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。
您还可以使用以下命令查看服务器日志：
bash
tail -n 20 -f ~/Library/Logs/Claude/mcp-server-overseerr-mcp.log
