npm - mcp-arr-server - Versions diffs - 1.0.0 - Mend

mcp-arr-server 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/arr-client.js ADDED Viewed

@@ -0,0 +1,291 @@
+/**
+ * *arr Suite API Client
+ *
+ * All *arr applications (Sonarr, Radarr, Lidarr, Readarr, Prowlarr) use
+ * the same REST API pattern with X-Api-Key header authentication.
+ */
+export class ArrClient {
+    config;
+    serviceName;
+    constructor(serviceName, config) {
+        this.serviceName = serviceName;
+        this.config = {
+            url: config.url.replace(/\/$/, ''),
+            apiKey: config.apiKey
+        };
+    }
+    /**
+     * Make an API request
+     */
+    async request(endpoint, options = {}) {
+        const url = `${this.config.url}/api/v3${endpoint}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            'X-Api-Key': this.config.apiKey,
+            ...(options.headers || {}),
+        };
+        const response = await fetch(url, {
+            ...options,
+            headers,
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`${this.serviceName} API error: ${response.status} ${response.statusText} - ${text}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get system status
+     */
+    async getStatus() {
+        return this.request('/system/status');
+    }
+    /**
+     * Get download queue
+     */
+    async getQueue() {
+        return this.request('/queue?includeUnknownSeriesItems=true&includeUnknownMovieItems=true');
+    }
+    /**
+     * Get calendar items (upcoming releases)
+     */
+    async getCalendar(start, end) {
+        const params = new URLSearchParams();
+        if (start)
+            params.append('start', start);
+        if (end)
+            params.append('end', end);
+        const query = params.toString() ? `?${params.toString()}` : '';
+        return this.request(`/calendar${query}`);
+    }
+    /**
+     * Get all root folders
+     */
+    async getRootFolders() {
+        return this.request('/rootfolder');
+    }
+    /**
+     * Get quality profiles
+     */
+    async getQualityProfiles() {
+        return this.request('/qualityprofile');
+    }
+    /**
+     * Test connection
+     */
+    async testConnection() {
+        try {
+            await this.getStatus();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// Service-specific clients
+export class SonarrClient extends ArrClient {
+    constructor(config) {
+        super('sonarr', config);
+    }
+    /**
+     * Get all series
+     */
+    async getSeries() {
+        return this['request']('/series');
+    }
+    /**
+     * Get a specific series
+     */
+    async getSeriesById(id) {
+        return this['request'](`/series/${id}`);
+    }
+    /**
+     * Search for series
+     */
+    async searchSeries(term) {
+        return this['request'](`/series/lookup?term=${encodeURIComponent(term)}`);
+    }
+    /**
+     * Add a series
+     */
+    async addSeries(series) {
+        return this['request']('/series', {
+            method: 'POST',
+            body: JSON.stringify({
+                ...series,
+                monitored: series.monitored ?? true,
+                seasonFolder: series.seasonFolder ?? true,
+                addOptions: {
+                    searchForMissingEpisodes: true,
+                },
+            }),
+        });
+    }
+    /**
+     * Trigger a search for missing episodes
+     */
+    async searchMissing(seriesId) {
+        await this['request']('/command', {
+            method: 'POST',
+            body: JSON.stringify({
+                name: 'SeriesSearch',
+                seriesId,
+            }),
+        });
+    }
+}
+export class RadarrClient extends ArrClient {
+    constructor(config) {
+        super('radarr', config);
+    }
+    /**
+     * Get all movies
+     */
+    async getMovies() {
+        return this['request']('/movie');
+    }
+    /**
+     * Get a specific movie
+     */
+    async getMovieById(id) {
+        return this['request'](`/movie/${id}`);
+    }
+    /**
+     * Search for movies
+     */
+    async searchMovies(term) {
+        return this['request'](`/movie/lookup?term=${encodeURIComponent(term)}`);
+    }
+    /**
+     * Add a movie
+     */
+    async addMovie(movie) {
+        return this['request']('/movie', {
+            method: 'POST',
+            body: JSON.stringify({
+                ...movie,
+                monitored: movie.monitored ?? true,
+                addOptions: {
+                    searchForMovie: true,
+                },
+            }),
+        });
+    }
+    /**
+     * Trigger a search for a movie
+     */
+    async searchMovie(movieId) {
+        await this['request']('/command', {
+            method: 'POST',
+            body: JSON.stringify({
+                name: 'MoviesSearch',
+                movieIds: [movieId],
+            }),
+        });
+    }
+}
+export class LidarrClient extends ArrClient {
+    constructor(config) {
+        super('lidarr', config);
+    }
+    /**
+     * Get all artists
+     */
+    async getArtists() {
+        return this['request']('/artist');
+    }
+    /**
+     * Get a specific artist
+     */
+    async getArtistById(id) {
+        return this['request'](`/artist/${id}`);
+    }
+    /**
+     * Search for artists
+     */
+    async searchArtists(term) {
+        return this['request'](`/artist/lookup?term=${encodeURIComponent(term)}`);
+    }
+    /**
+     * Add an artist
+     */
+    async addArtist(artist) {
+        return this['request']('/artist', {
+            method: 'POST',
+            body: JSON.stringify({
+                ...artist,
+                monitored: artist.monitored ?? true,
+                addOptions: {
+                    searchForMissingAlbums: true,
+                },
+            }),
+        });
+    }
+}
+export class ReadarrClient extends ArrClient {
+    constructor(config) {
+        super('readarr', config);
+    }
+    /**
+     * Get all authors
+     */
+    async getAuthors() {
+        return this['request']('/author');
+    }
+    /**
+     * Get a specific author
+     */
+    async getAuthorById(id) {
+        return this['request'](`/author/${id}`);
+    }
+    /**
+     * Search for authors
+     */
+    async searchAuthors(term) {
+        return this['request'](`/author/lookup?term=${encodeURIComponent(term)}`);
+    }
+    /**
+     * Add an author
+     */
+    async addAuthor(author) {
+        return this['request']('/author', {
+            method: 'POST',
+            body: JSON.stringify({
+                ...author,
+                monitored: author.monitored ?? true,
+                addOptions: {
+                    searchForMissingBooks: true,
+                },
+            }),
+        });
+    }
+}
+export class ProwlarrClient extends ArrClient {
+    constructor(config) {
+        super('prowlarr', config);
+    }
+    /**
+     * Get all indexers
+     */
+    async getIndexers() {
+        return this['request']('/indexer');
+    }
+    /**
+     * Test all indexers
+     */
+    async testAllIndexers() {
+        await this['request']('/indexer/testall', { method: 'POST' });
+    }
+    /**
+     * Search across all indexers
+     */
+    async search(query, categories) {
+        const params = new URLSearchParams({ query });
+        if (categories) {
+            categories.forEach(c => params.append('categories', c.toString()));
+        }
+        return this['request'](`/search?${params.toString()}`);
+    }
+}
+//# sourceMappingURL=arr-client.js.map

package/dist/arr-client.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"arr-client.js","sourceRoot":"","sources":["../src/arr-client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * MCP Server for *arr Media Management Suite
+ *
+ * Provides tools for managing Sonarr (TV), Radarr (Movies), Lidarr (Music),
+ * Readarr (Books), and Prowlarr (Indexers) through Claude Code.
+ *
+ * Environment variables:
+ * - SONARR_URL, SONARR_API_KEY
+ * - RADARR_URL, RADARR_API_KEY
+ * - LIDARR_URL, LIDARR_API_KEY
+ * - READARR_URL, READARR_API_KEY
+ * - PROWLARR_URL, PROWLARR_API_KEY
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG"}