MCP Mediastack

mcp媒体堆栈

支持服务列表

• 索纳尔 -电视剧管理
• 拉达尔 -电影管理
• SABnzbd -Usenet下载器
• qBittorrent -Torrent客户端
• Prowlarr -索引器管理
• Readarr -图书管理
• 巴扎 -字幕管理
• 塞尔 -媒体请求
• 胶屯 -VPN状态监控

快速开始

Docker运行

docker run -d \
  --name mediastack-mcp \
  -p 8888:8888 \
  -e MCP_TRANSPORT=sse \
  -e NAS_HOST=192.168.1.100 \
  -e SONARR_API_KEY=your_key \
  -e RADARR_API_KEY=your_key \
  -e SABNZBD_API_KEY=your_key \
  ghcr.io/aderaaij/mcp-mediastack:latest

Docker Compose

services:
  mediastack-mcp:
    image: ghcr.io/aderaaij/mcp-mediastack:latest
    container_name: mediastack-mcp
    restart: unless-stopped
    ports:
      - 8888:8888
    environment:
      - MCP_TRANSPORT=sse
      - MCP_PORT=8888
      - NAS_HOST=192.168.1.100
      - SONARR_API_KEY=${SONARR_API_KEY}
      - RADARR_API_KEY=${RADARR_API_KEY}
      - SABNZBD_API_KEY=${SABNZBD_API_KEY}
      - PROWLARR_API_KEY=${PROWLARR_API_KEY}
      - READARR_API_KEY=${READARR_API_KEY}
      - BAZARR_API_KEY=${BAZARR_API_KEY}
      - SEERR_API_KEY=${SEERR_API_KEY}
      - QBITTORRENT_USERNAME=${QBITTORRENT_USERNAME}
      - QBITTORRENT_PASSWORD=${QBITTORRENT_PASSWORD}

环境变量

选择性工具加载

根据API密钥的设置自动加载工具。只设置您使用的服务的密钥——未配置服务的工具将不会被注册。

• API关键服务 （Sonarr、Radarr、Readarr、Prowlarr、Bazarr、SABnzbd、Seerr）：当他们的API密钥为非空时启用
• qBittorrent和VPN：默认情况下启用（没有API密钥）。使用 DISABLED_SERVICES=vpn,qbittorrent 禁用
• ENABLED_SERVICES：用明确的白名单覆盖自动检测（例如。 ENABLED_SERVICES=sonarr,radarr)

工具

监控（28个工具）

行动（17个工具）

Claude桌面集成

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

直接（stdio，同一台机器）

{
  "mcpServers": {
    "mediastack": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "NAS_HOST=192.168.1.100",
        "-e", "SONARR_API_KEY=your_key",
        "ghcr.io/aderaaij/mcp-mediastack:latest"
      ]
    }
  }
}

远程（SSE通过mcp远程）

如果服务器在具有SSE传输的远程主机上运行：

{
  "mcpServers": {
    "mediastack": {
      "command": "npx",
      "args": ["mcp-remote", "http://your-server:8888/sse"]
    }
  }
}

已知问答

• httpx参数：永远不要通过 params={} （空字典）到httpx——它从URL中删除查询参数 params 当非空时。
• Seerr标题：Seerr请求不直接包含标题。服务器使用媒体的TMDB ID通过TMDB查找来解析它们。
• qBittorrent身份验证：使用基于会话的cookie验证，而不是API密钥。服务器自动处理登录。

发展

# Install dependencies
uv sync

# Run locally (stdio mode)
python -m mcp_mediastack

# Run locally (SSE mode)
MCP_TRANSPORT=sse python -m mcp_mediastack

许可证

麻省理工学院