mcp-arr

mcp-arr is a dedicated MCP server that provides a media management interface and tooling as part of the arr media management suite. It is distributed as a cross-platform executable installer, and can also be run via Docker if you prefer containerized deployment. Once running, you can connect your MCP-enabled clients to the server to manage media libraries, configure download and organization options, and leverage integration points with other tools in the arr ecosystem. The server emphasizes ease of use with a graphical interface and straightforward configuration for local media libraries and preferred formats.

Prerequisites:

• A supported platform (Windows, macOS, or Linux).
• For containerized deployments, Docker must be installed and running.
• Optional: Node.js or other runtime is not required if you use the provided installers or Docker image.

Installation options:

Option A: Desktop installer (recommended for end users)

1. Visit the download page and download the latest installer for your OS (Windows .exe, macOS .dmg, or Linux package).
2. Run the installer and follow the on-screen prompts to complete installation.
3. Launch the application from your applications menu or desktop shortcut and configure your media library locations.

Option B: Docker (containerized deployment)

1. Ensure Docker is installed and running on your system.
2. Pull and run the MCP server image: docker run -it --rm -p 8080:8080 nunner322/mcp-arr:latest
3. Open your browser and navigate to http://localhost:8080 (adjust port if you mapped differently).
4. Configure your media libraries and preferences within the web UI.

Option C: Legacy or alternative packaging If you prefer other packaging formats, refer to the downloads page for any available deb, rpm, or other installers and follow the provided platform-specific instructions.

Tips and caveats:

• The MCP server integrates with the arr media management suite; ensure compatibility with your existing arr components.
• When using Docker, map ports and volumes to persist configuration and media libraries as needed.
• Check for updates on the releases page to keep the MCP server and its integrations current.
• If you encounter issues, verify that your media library paths are accessible by the running process and that any required permissions are granted.
• Environment variables can be used to customize configuration paths or feature toggles; consult the documentation for available options.