Jellyseerr MCP Server

Jellyseerr MCP Server

Jellyserr MCP服务器

 ](https://www.python.org/downloads/)  

](https://github.com/aserper/jellyseerr-mcp) ](https://github.com/aserper/jellyseerr-mcp/fork)

Jellyseer的MCP（模型上下文协议）服务器，将Jellyserer API功能公开为LLM客户端可用的MCP工具。它包括丰富多彩的、表情符号形式的日志记录和清晰的控制台输出。

特性

• 将关键的Jellyserr端点作为MCP工具公开（搜索、请求、获取请求状态等）
• 具有强大错误处理和超时功能的同步HTTP客户端
• 丰富多彩、结构化的日志记录，通过Rich with表情符号指示器
• 通过环境变量进行配置(.env 支持）
• 与多mcp配置兼容的非阻塞stdio服务器

需求

• Python 3.10+
• 包裹在 requirements.txt

设置

1. 创建并激活virtualenv。
2. pip install -r requirements.txt
3. 复制 .env.example 到 .env 并设定你的价值观。

JELLYSEERR_URL=https://your-jellyseerr.example.com
JELLYSEERR_API_KEY=your_api_key_here
JELLYSEERR_TIMEOUT=15

运行MCP服务器

python -m jellyseerr_mcp

您应该看到彩色日志，表明服务器已在stdio上准备就绪。服务器通过stdin/stdout进行通信，使其与Claude Desktop和其他MCP客户端兼容。

码头工人

您可以通过从GitHub容器注册表（GHCR）中提取预构建的映像或自己构建映像来使用Docker运行服务器。

从GHCR中提取

docker pull ghcr.io/aserper/jellyseerr-mcp:latest

本地建设

docker build -t jellyseerr-mcp .

跑

# If you pulled from GHCR:
docker run --rm -it \
  -e JELLYSEERR_URL="https://your-jellyseerr.com" \
  -e JELLYSEERR_API_KEY="your_api_key" \
  ghcr.io/aserper/jellyseerr-mcp:latest

# If you built locally:
docker run --rm -it \
  -e JELLYSEERR_URL="https://your-jellyseerr.com" \
  -e JELLYSEERR_API_KEY="your_api_key" \
  jellyseerr-mcp

多MCP配置

该服务器旨在与多mcp配置无缝协作。示例 mcp.json:

{
  "mcpServers": {
    "jellyseerr": {
      "command": "/path/to/.venv/bin/python",
      "args": ["-m", "jellyseerr_mcp"],
      "env": {
        "JELLYSEERR_URL": "https://your-jellyseerr.example.com",
        "JELLYSEERR_API_KEY": "your_api_key_here"
      }
    }
  }
}

外露工具（初始设置）

• search_media(query: str) --通过查询在Jellyserr中搜索媒体。
• request_media(media_id: int, media_type: str) --创建媒体请求。
• get_request(request_id: int) --获取请求的详细信息/状态。
• ping() --使用服务器/传输信息进行活体检查。

可以轻松添加更多工具——请参阅 jellyseerr_mcp/server.py.