navidrome-mcp 1.0.1

package/dist/tools/listening-history.js

@@ -0,0 +1,126 @@
+/**
+ * Navidrome MCP Server - Listening History Tools
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { z } from 'zod';
+import { logger } from '../utils/logger.js';
+import { transformSongsToDTO, transformAlbumsToDTO, transformArtistsToDTO } from '../transformers/song-transformer.js';
+import { DEFAULT_VALUES } from '../constants/defaults.js';
+// Helper function to parse duration from MM:SS format to seconds
+function parseDuration(durationFormatted) {
+    const parts = durationFormatted.split(':');
+    if (parts.length === 2) {
+        const minutes = parseInt(parts[0] || '0', 10);
+        const seconds = parseInt(parts[1] || '0', 10);
+        return minutes * 60 + seconds;
+    }
+    return 0;
+}
+const RecentlyPlayedSchema = z.object({
+    limit: z.number().min(1).max(500).optional().default(DEFAULT_VALUES.RECENTLY_PLAYED_LIMIT),
+    offset: z.number().min(0).optional().default(0),
+    timeRange: z.enum(['today', 'week', 'month', 'all']).optional().default('all'),
+});
+export async function listRecentlyPlayed(client, args) {
+    const { limit = 20, offset = 0, timeRange = 'all' } = RecentlyPlayedSchema.parse(args);
+    logger.info(`Getting recently played songs (${timeRange})`);
+    // For now, we'll get songs sorted by addedDate (when added to library) as a proxy for recently played
+    // The API doesn't appear to support playDate filtering reliably
+    const response = await client.request(`/song?_sort=addedDate&_order=DESC&_start=${offset}&_end=${offset + limit}`);
+    // Transform using proper transformer
+    const songs = transformSongsToDTO(response);
+    // Filter songs that have been played at least once, if available
+    const playedSongs = songs.filter(song => !song.playCount || song.playCount > 0);
+    const tracks = playedSongs.slice(0, limit).map((song) => {
+        const track = {
+            id: song.id,
+            title: song.title,
+            artist: song.artist,
+            album: song.album,
+            playCount: song.playCount || 0,
+            duration: parseDuration(song.durationFormatted),
+            // Note: Real lastPlayed timestamps are not available from the API
+            // Only including lastPlayed if we actually have play date data (which we don't currently)
+        };
+        // Only add lastPlayed if we have actual play date data
+        // Currently, the API doesn't provide reliable play date information
+        // so we omit this field rather than provide misleading data
+        return track;
+    });
+    return {
+        timeRange,
+        count: tracks.length,
+        tracks,
+    };
+}
+const MostPlayedSchema = z.object({
+    type: z.enum(['songs', 'albums', 'artists']).optional().default('songs'),
+    limit: z.number().min(1).max(500).optional().default(DEFAULT_VALUES.MOST_PLAYED_LIMIT),
+    offset: z.number().min(0).optional().default(0),
+    minPlayCount: z.number().min(1).optional().default(1),
+});
+export async function listMostPlayed(client, args) {
+    const { type = 'songs', limit = 20, offset = 0, minPlayCount = 1 } = MostPlayedSchema.parse(args);
+    logger.info(`Getting most played ${type} with minPlayCount: ${minPlayCount}`);
+    const endpoint = type === 'songs' ? '/song' : type === 'albums' ? '/album' : '/artist';
+    // Fetch more items to account for filtering by minPlayCount
+    // We'll fetch 3x the requested amount to ensure we have enough after filtering
+    const fetchLimit = limit * 3;
+    const response = await client.request(`${endpoint}?_sort=playCount&_order=DESC&_start=${offset}&_end=${offset + fetchLimit}`);
+    // Transform using the appropriate transformer
+    let transformedItems;
+    if (type === 'songs') {
+        const songs = transformSongsToDTO(response);
+        transformedItems = songs.map(song => ({
+            id: song.id,
+            title: song.title,
+            artist: song.artist,
+            album: song.album,
+            playCount: song.playCount || 0
+        }));
+    }
+    else if (type === 'albums') {
+        const albums = transformAlbumsToDTO(response);
+        transformedItems = albums.map(album => ({
+            id: album.id,
+            name: album.name,
+            artist: album.artist,
+            songCount: album.songCount,
+            playCount: album.playCount || 0
+        }));
+    }
+    else {
+        const artists = transformArtistsToDTO(response);
+        transformedItems = artists.map(artist => ({
+            id: artist.id,
+            name: artist.name,
+            albumCount: artist.albumCount,
+            songCount: artist.songCount,
+            playCount: artist.playCount || 0
+        }));
+    }
+    // Filter by minPlayCount and limit results
+    const filteredItems = transformedItems
+        .filter(item => (item.playCount || 0) >= minPlayCount)
+        .slice(0, limit);
+    return {
+        type,
+        minPlayCount,
+        count: filteredItems.length,
+        items: filteredItems,
+    };
+}
+//# sourceMappingURL=listening-history.js.map

package/dist/tools/listening-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listening-history.js","sourceRoot":"","sources":["../../src/tools/listening-history.ts"],"names":[],"mappings":"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"}

package/dist/tools/lyrics.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Navidrome MCP Server - Lyrics Tools
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { z } from 'zod';
+import type { LyricsDTO } from '../types/index.js';
+import type { Config } from '../config.js';
+/**
+ * Schema for getting lyrics
+ */
+export declare const GetLyricsArgsSchema: z.ZodObject<{
+    title: z.ZodString;
+    artist: z.ZodString;
+    album: z.ZodOptional<z.ZodString>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Get lyrics for a song
+ */
+export declare function getLyrics(config: Config, args: unknown): Promise<LyricsDTO>;
+//# sourceMappingURL=lyrics.d.ts.map

package/dist/tools/lyrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lyrics.d.ts","sourceRoot":"","sources":["../../src/tools/lyrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;iBAM9B,CAAC;AA4JH;;GAEG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAyEjF"}

package/dist/tools/lyrics.js

@@ -0,0 +1,222 @@
+/**
+ * Navidrome MCP Server - Lyrics Tools
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { z } from 'zod';
+import { ErrorFormatter } from '../utils/error-formatter.js';
+/**
+ * Schema for getting lyrics
+ */
+export const GetLyricsArgsSchema = z.object({
+    title: z.string(),
+    artist: z.string(),
+    album: z.string().optional(),
+    durationMs: z.number().min(0).optional(),
+    id: z.string().optional()
+});
+/**
+ * Parse LRC format synced lyrics into structured format
+ */
+function parseSyncedLyrics(lrcText) {
+    const lines = [];
+    const lrcRegex = /\[(\d{2}):(\d{2})\.(\d{2})\](.+)/g;
+    let match;
+    while ((match = lrcRegex.exec(lrcText)) !== null) {
+        const [, minutesStr, secondsStr, centisecondsStr, textStr] = match;
+        if (!minutesStr || !secondsStr || !centisecondsStr || !textStr)
+            continue;
+        const minutes = parseInt(minutesStr, 10);
+        const seconds = parseInt(secondsStr, 10);
+        const centiseconds = parseInt(centisecondsStr, 10);
+        const timeMs = (minutes * 60 + seconds) * 1000 + centiseconds * 10;
+        const text = textStr.trim();
+        if (text) {
+            lines.push({ timeMs, text });
+        }
+    }
+    return lines;
+}
+/**
+ * Try to get lyrics using exact match
+ */
+async function tryExactMatch(params, config) {
+    try {
+        const url = new URL('/api/get', config.lrclibBase);
+        if (params.id) {
+            url.searchParams.set('id', params.id);
+        }
+        else {
+            url.searchParams.set('track_name', params.title);
+            url.searchParams.set('artist_name', params.artist);
+            if (params.album)
+                url.searchParams.set('album_name', params.album);
+            if (params.durationMs)
+                url.searchParams.set('duration', String(Math.round(params.durationMs / 1000)));
+        }
+        const response = await fetch(url.toString(), {
+            headers: {
+                'User-Agent': config.lrclibUserAgent || 'Navidrome-MCP/1.0',
+                'Accept': 'application/json'
+            }
+        });
+        if (response.status === 404) {
+            return null;
+        }
+        if (!response.ok) {
+            throw new Error(ErrorFormatter.httpRequest('LRCLIB API', response));
+        }
+        return await response.json();
+    }
+    catch {
+        // If exact match fails, return null to try search
+        return null;
+    }
+}
+/**
+ * Search for lyrics and find best match
+ */
+async function searchLyrics(params, config) {
+    try {
+        const url = new URL('/api/search', config.lrclibBase);
+        url.searchParams.set('query', `${params.title} ${params.artist}`);
+        if (params.durationMs) {
+            url.searchParams.set('duration', String(Math.round(params.durationMs / 1000)));
+        }
+        const response = await fetch(url.toString(), {
+            headers: {
+                'User-Agent': config.lrclibUserAgent || 'Navidrome-MCP/1.0',
+                'Accept': 'application/json'
+            }
+        });
+        if (!response.ok) {
+            throw new Error(ErrorFormatter.httpRequest('LRCLIB search API', response));
+        }
+        const results = await response.json();
+        if (!results || results.length === 0) {
+            return null;
+        }
+        // Find best match
+        // 1. Prefer exact artist and title match
+        // 2. If duration provided, prefer within 3% tolerance
+        const titleLower = params.title.toLowerCase();
+        const artistLower = params.artist.toLowerCase();
+        const durationSec = params.durationMs ? params.durationMs / 1000 : null;
+        let bestMatch = null;
+        let bestScore = -1;
+        for (const result of results) {
+            let score = 0;
+            // Check title match
+            if (result.trackName?.toLowerCase() === titleLower) {
+                score += 10;
+            }
+            else if (result.trackName?.toLowerCase().includes(titleLower)) {
+                score += 5;
+            }
+            // Check artist match
+            if (result.artistName?.toLowerCase() === artistLower) {
+                score += 10;
+            }
+            else if (result.artistName?.toLowerCase().includes(artistLower)) {
+                score += 5;
+            }
+            // Check duration match (within 3% tolerance)
+            if (durationSec && result.duration) {
+                const tolerance = durationSec * 0.03;
+                const diff = Math.abs(result.duration - durationSec);
+                if (diff <= tolerance) {
+                    score += 5;
+                }
+            }
+            if (score > bestScore) {
+                bestScore = score;
+                bestMatch = result;
+            }
+        }
+        return bestMatch;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get lyrics for a song
+ */
+export async function getLyrics(config, args) {
+    const params = GetLyricsArgsSchema.parse(args);
+    try {
+        // Try exact match first
+        let lyricsData = await tryExactMatch(params, config);
+        // If no exact match, try searching
+        if (!lyricsData) {
+            lyricsData = await searchLyrics(params, config);
+        }
+        // If still no match, return empty lyrics
+        if (!lyricsData) {
+            const result = {
+                track: {
+                    title: params.title,
+                    artist: params.artist,
+                    ...(params.album ? { album: params.album } : {}),
+                    ...(params.durationMs ? { durationMs: params.durationMs } : {})
+                },
+                isInstrumental: false,
+                provider: 'lrclib',
+                attribution: {
+                    url: 'https://lrclib.net',
+                    license: 'community-sourced'
+                }
+            };
+            return result;
+        }
+        // Parse synced lyrics if available
+        let syncedLines;
+        if (lyricsData.syncedLyrics) {
+            syncedLines = parseSyncedLyrics(lyricsData.syncedLyrics);
+        }
+        const result = {
+            track: {
+                title: lyricsData.trackName || params.title,
+                artist: lyricsData.artistName || params.artist
+            },
+            isInstrumental: Boolean(lyricsData.instrumental),
+            provider: 'lrclib',
+            attribution: {
+                url: 'https://lrclib.net',
+                license: 'community-sourced'
+            }
+        };
+        // Add optional fields only if they have values
+        const album = lyricsData.albumName || params.album;
+        if (album) {
+            result.track.album = album;
+        }
+        const durationMs = lyricsData.duration ? lyricsData.duration * 1000 : params.durationMs;
+        if (durationMs) {
+            result.track.durationMs = durationMs;
+        }
+        if (syncedLines && syncedLines.length > 0) {
+            result.synced = syncedLines;
+        }
+        if (lyricsData.plainLyrics) {
+            result.unsynced = lyricsData.plainLyrics;
+        }
+        return result;
+    }
+    catch (error) {
+        throw new Error(ErrorFormatter.toolExecution('getLyrics', error));
+    }
+}
+//# sourceMappingURL=lyrics.js.map

package/dist/tools/lyrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lyrics.js","sourceRoot":"","sources":["../../src/tools/lyrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC1B,CAAC,CAAC;AAgBH;;GAEG;AACH,SAAS,iBAAiB,CAAC,OAAe;IACxC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,mCAAmC,CAAC;IAErD,IAAI,KAAK,CAAC;IACV,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACjD,MAAM,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;QACnE,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,IAAI,CAAC,eAAe,IAAI,CAAC,OAAO;YAAE,SAAS;QAEzE,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,GAAG,YAAY,GAAG,EAAE,CAAC;QACnE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAE5B,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,aAAa,CAAC,MAA2C,EAAE,MAAc;IACtF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAEnD,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACjD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YACnD,IAAI,MAAM,CAAC,KAAK;gBAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,IAAI,MAAM,CAAC,UAAU;gBAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACxG,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YAC3C,OAAO,EAAE;gBACP,YAAY,EAAE,MAAM,CAAC,eAAe,IAAI,mBAAmB;gBAC3D,QAAQ,EAAE,kBAAkB;aAC7B;SACF,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAoB,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,YAAY,CAAC,MAA2C,EAAE,MAAc;IACrF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QACtD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YAC3C,OAAO,EAAE;gBACP,YAAY,EAAE,MAAM,CAAC,eAAe,IAAI,mBAAmB;gBAC3D,QAAQ,EAAE,kBAAkB;aAC7B;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAsB,CAAC;QAE1D,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,kBAAkB;QAClB,yCAAyC;QACzC,sDAAsD;QACtD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAChD,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAExE,IAAI,SAAS,GAA0B,IAAI,CAAC;QAC5C,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;QAEnB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;YAEd,oBAAoB;YACpB,IAAI,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,CAAC;gBACnD,KAAK,IAAI,EAAE,CAAC;YACd,CAAC;iBAAM,IAAI,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChE,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;YAED,qBAAqB;YACrB,IAAI,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC;gBACrD,KAAK,IAAI,EAAE,CAAC;YACd,CAAC;iBAAM,IAAI,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClE,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;YAED,6CAA6C;YAC7C,IAAI,WAAW,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACnC,MAAM,SAAS,GAAG,WAAW,GAAG,IAAI,CAAC;gBACrC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,GAAG,WAAW,CAAC,CAAC;gBACrD,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC;oBACtB,KAAK,IAAI,CAAC,CAAC;gBACb,CAAC;YACH,CAAC;YAED,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;gBACtB,SAAS,GAAG,KAAK,CAAC;gBAClB,SAAS,GAAG,MAAM,CAAC;YACrB,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAc,EAAE,IAAa;IAC3D,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE/C,IAAI,CAAC;QACH,wBAAwB;QACxB,IAAI,UAAU,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAErD,mCAAmC;QACnC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,UAAU,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QAED,yCAAyC;QACzC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,MAAM,GAAc;gBACxB,KAAK,EAAE;oBACL,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChD,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAChE;gBACD,cAAc,EAAE,KAAK;gBACrB,QAAQ,EAAE,QAAQ;gBAClB,WAAW,EAAE;oBACX,GAAG,EAAE,oBAAoB;oBACzB,OAAO,EAAE,mBAAmB;iBAC7B;aACF,CAAC;YACF,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,mCAAmC;QACnC,IAAI,WAAqC,CAAC;QAC1C,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC;YAC5B,WAAW,GAAG,iBAAiB,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,MAAM,GAAc;YACxB,KAAK,EAAE;gBACL,KAAK,EAAE,UAAU,CAAC,SAAS,IAAI,MAAM,CAAC,KAAK;gBAC3C,MAAM,EAAE,UAAU,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM;aAC/C;YACD,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC;YAChD,QAAQ,EAAE,QAAQ;YAClB,WAAW,EAAE;gBACX,GAAG,EAAE,oBAAoB;gBACzB,OAAO,EAAE,mBAAmB;aAC7B;SACF,CAAC;QAEF,+CAA+C;QAC/C,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC;QACnD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QAC7B,CAAC;QAED,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QACxF,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC;QACvC,CAAC;QAED,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC;QAC9B,CAAC;QAED,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;YAC3B,MAAM,CAAC,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC;QAC3C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

package/dist/tools/media-library.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Navidrome MCP Server - Media Library Tools
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import type { NavidromeClient } from '../client/navidrome-client.js';
+import type { Config } from '../config.js';
+import type { SongDTO, AlbumDTO, ArtistDTO, GenreDTO, PlaylistDTO } from '../types/index.js';
+export declare function listAlbums(client: NavidromeClient, args: unknown): Promise<{
+    albums: AlbumDTO[];
+    total: number;
+    offset: number;
+    limit: number;
+}>;
+export declare function listArtists(client: NavidromeClient, args: unknown): Promise<{
+    artists: ArtistDTO[];
+    total: number;
+    offset: number;
+    limit: number;
+}>;
+export declare function listGenres(_client: NavidromeClient, config: Config, args: unknown): Promise<{
+    genres: GenreDTO[];
+    total: number;
+    offset: number;
+    limit: number;
+}>;
+export declare function getSong(client: NavidromeClient, args: unknown): Promise<SongDTO>;
+export declare function getAlbum(client: NavidromeClient, args: unknown): Promise<AlbumDTO>;
+export declare function getArtist(client: NavidromeClient, args: unknown): Promise<ArtistDTO>;
+export declare function getSongPlaylists(client: NavidromeClient, args: unknown): Promise<{
+    playlists: PlaylistDTO[];
+    songId: string;
+}>;
+//# sourceMappingURL=media-library.d.ts.map

package/dist/tools/media-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-library.d.ts","sourceRoot":"","sources":["../../src/tools/media-library.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAa3C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAU7F,wBAAsB,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAChF,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAyBD;AAGD,wBAAsB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACjF,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAyBD;AAoBD,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACjG,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAoDD;AAGD,wBAAsB,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAWtF;AAGD,wBAAsB,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAWxF;AAGD,wBAAsB,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAW1F;AAGD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACtF,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CA6BD"}

package/dist/tools/media-library.js

@@ -0,0 +1,179 @@
+/**
+ * Navidrome MCP Server - Media Library Tools
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import crypto from 'crypto';
+import { logger } from '../utils/logger.js';
+import { transformAlbumsToDTO, transformArtistsToDTO, transformPlaylistsToDTO, transformToSongDTO, transformToAlbumDTO, transformToArtistDTO, } from '../transformers/song-transformer.js';
+import { AlbumPaginationSchema, ArtistPaginationSchema, GenrePaginationSchema, IdSchema, GetSongPlaylistsSchema, } from '../schemas/index.js';
+// List Albums
+export async function listAlbums(client, args) {
+    const params = AlbumPaginationSchema.parse(args);
+    try {
+        const queryParams = new URLSearchParams({
+            _start: params.offset.toString(),
+            _end: (params.offset + params.limit).toString(),
+            _sort: params.sort,
+            _order: params.order,
+        });
+        const rawAlbums = await client.request(`/album?${queryParams.toString()}`);
+        const albums = transformAlbumsToDTO(rawAlbums);
+        return {
+            albums,
+            total: albums.length,
+            offset: params.offset,
+            limit: params.limit,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch albums: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+// List Artists
+export async function listArtists(client, args) {
+    const params = ArtistPaginationSchema.parse(args);
+    try {
+        const queryParams = new URLSearchParams({
+            _start: params.offset.toString(),
+            _end: (params.offset + params.limit).toString(),
+            _sort: params.sort,
+            _order: params.order,
+        });
+        const rawArtists = await client.request(`/artist?${queryParams.toString()}`);
+        const artists = transformArtistsToDTO(rawArtists);
+        return {
+            artists,
+            total: artists.length,
+            offset: params.offset,
+            limit: params.limit,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch artists: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Create Subsonic API authentication parameters for genres
+ */
+function createSubsonicAuthForGenres(config) {
+    const salt = crypto.randomBytes(16).toString('hex');
+    const token = crypto.createHash('md5').update(config.navidromePassword + salt).digest('hex');
+    return new URLSearchParams({
+        u: config.navidromeUsername,
+        t: token,
+        s: salt,
+        v: '1.16.1',
+        c: 'NavidromeMCP',
+        f: 'json',
+    });
+}
+// List Genres
+export async function listGenres(_client, config, args) {
+    const params = GenrePaginationSchema.parse(args);
+    try {
+        // Use direct fetch to Subsonic API (not through our client since it adds /api prefix)
+        const authParams = createSubsonicAuthForGenres(config);
+        const subsonicUrl = `${config.navidromeUrl}/rest/getGenres?${authParams.toString()}`;
+        const subsonicResponse = await fetch(subsonicUrl);
+        if (!subsonicResponse.ok) {
+            throw new Error(`Subsonic API request failed: ${subsonicResponse.status} ${subsonicResponse.statusText}`);
+        }
+        const response = await subsonicResponse.json();
+        // Extract genres from Subsonic response structure
+        const subsonicGenres = response?.['subsonic-response']?.genres?.genre || [];
+        // Transform Subsonic genre format to our DTO
+        const allGenres = subsonicGenres.map((genre) => ({
+            id: genre.value || '', // Subsonic uses 'value' for genre name as ID
+            name: genre.value || '',
+            songCount: genre.songCount || 0,
+            albumCount: genre.albumCount || 0,
+        }));
+        // Apply pagination manually since Subsonic getGenres doesn't support it
+        const startIndex = params.offset;
+        const endIndex = Math.min(startIndex + params.limit, allGenres.length);
+        const paginatedGenres = allGenres.slice(startIndex, endIndex);
+        return {
+            genres: paginatedGenres,
+            total: allGenres.length,
+            offset: params.offset,
+            limit: params.limit,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch genres: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+// Get Song by ID
+export async function getSong(client, args) {
+    const params = IdSchema.parse(args);
+    try {
+        const rawSong = await client.request(`/song/${params.id}`);
+        return transformToSongDTO(rawSong);
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch song: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+// Get Album by ID
+export async function getAlbum(client, args) {
+    const params = IdSchema.parse(args);
+    try {
+        const rawAlbum = await client.request(`/album/${params.id}`);
+        return transformToAlbumDTO(rawAlbum);
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch album: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+// Get Artist by ID
+export async function getArtist(client, args) {
+    const params = IdSchema.parse(args);
+    try {
+        const rawArtist = await client.request(`/artist/${params.id}`);
+        return transformToArtistDTO(rawArtist);
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch artist: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+// Get Playlists containing a song
+export async function getSongPlaylists(client, args) {
+    const params = GetSongPlaylistsSchema.parse(args);
+    try {
+        const rawPlaylists = await client.request(`/song/${params.songId}/playlists`);
+        // Workaround: This specific endpoint returns JSON data but with text/plain content-type
+        // So we need to parse it manually if it's a string
+        let playlistData = rawPlaylists;
+        if (typeof rawPlaylists === 'string') {
+            try {
+                playlistData = JSON.parse(rawPlaylists);
+            }
+            catch (parseError) {
+                logger.error('Failed to parse playlist data:', parseError);
+                playlistData = [];
+            }
+        }
+        const playlists = transformPlaylistsToDTO(playlistData);
+        return {
+            playlists,
+            songId: params.songId,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch song playlists: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+//# sourceMappingURL=media-library.js.map

package/dist/tools/media-library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-library.js","sourceRoot":"","sources":["../../src/tools/media-library.ts"],"names":[],"mappings":"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"}