navidrome-mcp 2.0.0 → 2.1.0

package/dist/client/navidrome-client.js

@@ -176,6 +176,20 @@ export class NavidromeClient {
         if (endpoint.includes('..')) {
             throw new Error('Endpoint must not contain path-traversal segments');
         }
+        // URL-encoded traversal (`%2e%2e`) survives the literal check above but
+        // Node normalizes it back to `..` before the request leaves the process.
+        // Decode and re-check; a malformed escape sequence is itself suspect, so
+        // reject it rather than letting it through.
+        let decoded;
+        try {
+            decoded = decodeURIComponent(endpoint);
+        }
+        catch {
+            throw new Error('Endpoint contains a malformed percent-encoding sequence');
+        }
+        if (decoded.includes('..')) {
+            throw new Error('Endpoint must not contain path-traversal segments');
+        }
         if (/^https?:\/\//i.test(endpoint)) {
             throw new Error('Endpoint must be a path, not an absolute URL');
         }
@@ -186,7 +200,7 @@ export class NavidromeClient {
             'X-ND-Authorization': `Bearer ${token}`,
         };
         // Only set Content-Type for non-GET requests
-        if (options.method !== null && options.method !== undefined && options.method !== 'GET') {
+        if (options.method !== undefined && options.method !== 'GET') {
             defaultHeaders['Content-Type'] = 'application/json';
         }
         // Only retry idempotent methods. POST/PUT/DELETE may have side effects
@@ -197,12 +211,20 @@ export class NavidromeClient {
         // to GET in fetch().
         const method = options.method ?? 'GET';
         const isIdempotent = method === 'GET' || method === 'HEAD';
+        // RequestInit.headers is HeadersInit, which can be a Headers instance, a
+        // [k, v][] tuple array, or a plain object. Object-spreading a Headers
+        // instance yields `{}` and silently drops the caller's headers, so merge
+        // via the Headers API to preserve every form. Caller headers win on
+        // collision (last write).
+        const merged = new Headers(defaultHeaders);
+        if (options.headers !== undefined) {
+            new Headers(options.headers).forEach((value, key) => {
+                merged.set(key, value);
+            });
+        }
         return fetchWithTimeout(`${this.baseUrl}/api${endpoint}`, {
             ...options,
-            headers: {
-                ...defaultHeaders,
-                ...options.headers,
-            },
+            headers: merged,
         }, {
             timeoutMs: getNavidromeRequestTimeoutMs(),
             retryPolicy: isIdempotent ? 'safe' : 'never',
@@ -232,6 +254,13 @@ export class NavidromeClient {
                 // Body looked like JSON but didn't parse — fall through to text.
             }
         }
+        // KNOWN LATENT TRAP (left as-is per maintainer decision): this cast is only
+        // sound when `T` is `string` or `unknown` — i.e. callers that genuinely want
+        // the raw text/plain body (M3U export, etc.). A future typed caller such as
+        // `request<AlbumDTO[]>()` whose endpoint returns a non-JSON text/plain body
+        // would silently receive a raw string typed as `AlbumDTO[]`, with no parse
+        // error. No current caller hits that path; revisit if a typed JSON caller
+        // starts relying on the text/plain fallthrough.
         return text;
     }
 }

package/dist/client/navidrome-client.js.map

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

package/dist/config/map-config.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Navidrome MCP Server - Settings store → flat Config projection
+ * 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 { RawConfigInput } from './schema.js';
+import type { SettingsFile } from './store.js';
+/**
+ * Project the nested store into the flat `RawConfigInput` that `ConfigSchema`
+ * validates. The single place the nested→flat translation lives, shared by
+ * `loadConfig()` and the settings server's "test connection" route.
+ *
+ * Performs mpv detection (so `features.playback` and `mpvPath` are correct),
+ * which means it is not side-effect-free (it may shell out via `command -v`).
+ */
+export declare function mapStoreToConfig(settings: SettingsFile): RawConfigInput;
+//# sourceMappingURL=map-config.d.ts.map

package/dist/config/map-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-config.d.ts","sourceRoot":"","sources":["../../src/config/map-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAa/C;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,cAAc,CAsEvE"}

package/dist/config/map-config.js

@@ -0,0 +1,97 @@
+/**
+ * Navidrome MCP Server - Settings store → flat Config projection
+ * 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 { resolveMpvBinary } from '../services/playback/mpv-process.js';
+import { DEFAULT_LRCLIB_BASE } from '../constants/defaults.js';
+// Kept in its own module (separate from store.ts's file I/O) so that the
+// read/write path does NOT transitively import the playback subsystem. Only the
+// config-resolution path (which legitimately needs mpv detection) pulls it in.
+/** Coerce null/undefined/blank strings to `undefined`; trim otherwise. */
+function nonEmpty(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed === '' ? undefined : trimmed;
+}
+/**
+ * Project the nested store into the flat `RawConfigInput` that `ConfigSchema`
+ * validates. The single place the nested→flat translation lives, shared by
+ * `loadConfig()` and the settings server's "test connection" route.
+ *
+ * Performs mpv detection (so `features.playback` and `mpvPath` are correct),
+ * which means it is not side-effect-free (it may shell out via `command -v`).
+ */
+export function mapStoreToConfig(settings) {
+    const nav = settings.navidrome ?? {};
+    const features = settings.features ?? {};
+    const playback = settings.playback ?? {};
+    const webui = settings.webui ?? {};
+    const advanced = settings.advanced ?? {};
+    const library = settings.library ?? {};
+    const lastFmApiKey = nonEmpty(features.lastFmApiKey);
+    const radioBrowserUserAgent = nonEmpty(features.radioBrowserUserAgent);
+    const lyricsProvider = nonEmpty(features.lyricsProvider);
+    const lrclibUserAgent = nonEmpty(features.lrclibUserAgent);
+    // mpv: explicit store path wins; null/empty → auto-detect. Drives the
+    // playback feature flag (and is omitted entirely when unresolved, matching
+    // the legacy behavior of only setting `mpvPath` when a binary exists).
+    const resolvedMpvPath = resolveMpvBinary(playback.mpvPath);
+    // defaultLibraryIds: an empty array means "all libraries" — same as unset.
+    const libIds = library.defaultLibraryIds;
+    const defaultLibraryIds = libIds !== undefined && libIds.length > 0 ? libIds : undefined;
+    // webui host: explicit host wins; otherwise `expose` flips the bind to
+    // 0.0.0.0 (replaces the legacy env-only buildWebUiConfig()).
+    const expose = webui.expose ?? false;
+    const explicitHost = nonEmpty(webui.host);
+    const host = explicitHost ?? (expose ? '0.0.0.0' : '127.0.0.1');
+    return {
+        navidromeUrl: nav.url ?? '',
+        navidromeUsername: nav.username ?? '',
+        navidromePassword: nav.password ?? '',
+        debug: advanced.debug ?? false,
+        cacheTtl: advanced.cacheTtl ?? 300,
+        tokenExpiry: advanced.tokenExpiry ?? 86400,
+        defaultLibraryIds,
+        features: {
+            lastfm: lastFmApiKey !== undefined,
+            radioBrowser: radioBrowserUserAgent !== undefined,
+            lyrics: lyricsProvider !== undefined && lrclibUserAgent !== undefined,
+            playback: resolvedMpvPath !== null,
+        },
+        lastFmApiKey,
+        radioBrowserUserAgent,
+        // Only an explicit, real URL pins the mirror; null/blank keeps SRV resolution.
+        radioBrowserBaseOverride: nonEmpty(features.radioBrowserBase),
+        lyricsProvider,
+        lrclibUserAgent,
+        // null/blank falls through to the canonical LRCLIB endpoint.
+        lrclibBase: nonEmpty(features.lrclibBase) ?? DEFAULT_LRCLIB_BASE,
+        ...(resolvedMpvPath !== null ? { mpvPath: resolvedMpvPath } : {}),
+        playbackTranscodeFormat: nonEmpty(playback.transcodeFormat) ?? 'raw',
+        playbackTranscodeBitrate: nonEmpty(playback.transcodeBitrate) ?? '192',
+        filterCacheEnabled: library.filterCacheEnabled ?? true,
+        webui: {
+            enabled: webui.enabled ?? true,
+            host,
+            port: webui.port ?? 8808,
+            expose,
+            autoOpenBrowser: webui.autoOpenBrowser ?? false,
+            persistAfterMcpExit: webui.persistAfterMcpExit ?? false,
+        },
+    };
+}
+//# sourceMappingURL=map-config.js.map

package/dist/config/map-config.js.map

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

package/dist/config/schema.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Navidrome MCP Server - Configuration Schema
+ * 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';
+/**
+ * The canonical runtime configuration shape. This is a *flat* projection of the
+ * nested `settings.json` store (see `src/config/store.ts`), kept flat because
+ * `NavidromeClient`, the playback engine, the managers, and every tool category
+ * read fields like `config.navidromeUrl` / `config.features.*` directly.
+ *
+ * Extracted into its own module (rather than living in `src/config.ts`) so that
+ * `store.ts` can map the nested store into this shape without a circular import
+ * back through `config.ts`.
+ */
+export declare const ConfigSchema: z.ZodObject<{
+    navidromeUrl: z.ZodString;
+    navidromeUsername: z.ZodString;
+    navidromePassword: z.ZodString;
+    debug: z.ZodDefault<z.ZodBoolean>;
+    cacheTtl: z.ZodDefault<z.ZodNumber>;
+    tokenExpiry: z.ZodDefault<z.ZodNumber>;
+    defaultLibraryIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    features: z.ZodObject<{
+        lastfm: z.ZodDefault<z.ZodBoolean>;
+        radioBrowser: z.ZodDefault<z.ZodBoolean>;
+        lyrics: z.ZodDefault<z.ZodBoolean>;
+        playback: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    lastFmApiKey: z.ZodOptional<z.ZodString>;
+    radioBrowserUserAgent: z.ZodOptional<z.ZodString>;
+    radioBrowserBaseOverride: z.ZodOptional<z.ZodString>;
+    lyricsProvider: z.ZodOptional<z.ZodString>;
+    lrclibUserAgent: z.ZodOptional<z.ZodString>;
+    lrclibBase: z.ZodDefault<z.ZodString>;
+    mpvPath: z.ZodOptional<z.ZodString>;
+    playbackTranscodeFormat: z.ZodDefault<z.ZodString>;
+    playbackTranscodeBitrate: z.ZodDefault<z.ZodString>;
+    filterCacheEnabled: z.ZodDefault<z.ZodBoolean>;
+    webui: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        host: z.ZodDefault<z.ZodString>;
+        port: z.ZodDefault<z.ZodNumber>;
+        expose: z.ZodDefault<z.ZodBoolean>;
+        autoOpenBrowser: z.ZodDefault<z.ZodBoolean>;
+        persistAfterMcpExit: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof ConfigSchema>;
+/** The pre-validation input shape (fields with defaults are optional). */
+export type RawConfigInput = z.input<typeof ConfigSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuEvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/config/schema.js

@@ -0,0 +1,95 @@
+/**
+ * Navidrome MCP Server - Configuration Schema
+ * 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 { DEFAULT_LRCLIB_BASE } from '../constants/defaults.js';
+/**
+ * The canonical runtime configuration shape. This is a *flat* projection of the
+ * nested `settings.json` store (see `src/config/store.ts`), kept flat because
+ * `NavidromeClient`, the playback engine, the managers, and every tool category
+ * read fields like `config.navidromeUrl` / `config.features.*` directly.
+ *
+ * Extracted into its own module (rather than living in `src/config.ts`) so that
+ * `store.ts` can map the nested store into this shape without a circular import
+ * back through `config.ts`.
+ */
+export const ConfigSchema = z.object({
+    navidromeUrl: z.string().url('NAVIDROME_URL must be a valid URL'),
+    navidromeUsername: z.string().min(1, 'NAVIDROME_USERNAME is required'),
+    navidromePassword: z.string().min(1, 'NAVIDROME_PASSWORD is required'),
+    debug: z.boolean().default(false),
+    cacheTtl: z.number().positive().default(300),
+    tokenExpiry: z.number().positive().default(86400), // Default 24 hours in seconds
+    // Library Configuration
+    defaultLibraryIds: z.array(z.number()).optional(),
+    // Feature Configuration
+    features: z.object({
+        lastfm: z.boolean().default(false),
+        radioBrowser: z.boolean().default(false),
+        lyrics: z.boolean().default(false),
+        playback: z.boolean().default(false),
+    }),
+    // API Keys and External Service Configuration
+    lastFmApiKey: z.string().optional(),
+    radioBrowserUserAgent: z.string().optional(),
+    // Set only when the user explicitly provides a Radio Browser base in the
+    // store — bypasses SRV resolution and pins to the chosen mirror. Production
+    // base resolution otherwise flows through `getRadioBrowserBase()` which does
+    // SRV-record lookup + caching, with a hardcoded fallback in
+    // `RADIO_BROWSER_FALLBACK_BASE`.
+    radioBrowserBaseOverride: z.string().url().optional(),
+    // Lyrics Configuration
+    lyricsProvider: z.string().optional(),
+    lrclibUserAgent: z.string().optional(),
+    lrclibBase: z.string().url().default(DEFAULT_LRCLIB_BASE),
+    // Playback (mpv) Configuration
+    mpvPath: z.string().optional(),
+    // 'raw' (default) streams the original file untouched: highest quality and
+    // fully seekable. Set a codec (e.g. 'mp3', 'opus') to transcode for limited
+    // bandwidth — `playbackTranscodeBitrate` then applies.
+    playbackTranscodeFormat: z.string().default('raw'),
+    playbackTranscodeBitrate: z.string().default('192'),
+    // Filter cache — when false, re-fetches tag/genre lists on every filter resolution
+    // instead of using the startup snapshot. Set to false if you curate your library
+    // mid-session and need newly-added genres/labels/moods to be immediately visible.
+    filterCacheEnabled: z.boolean().default(true),
+    // Web UI Configuration — companion HTTP control panel for mpv playback.
+    // The web UI is implicitly gated by the playback feature: it only ever
+    // initializes when mpv is detected. Even when `enabled` is true, the
+    // server does not bind a port until something has been queued.
+    // `host=127.0.0.1` keeps the panel on localhost only. Setting `expose=true`
+    // forces the bind to `0.0.0.0` so a phone on the same LAN can reach it;
+    // explicit `host` overrides this.
+    webui: z.object({
+        enabled: z.boolean().default(true),
+        host: z.string().default('127.0.0.1'),
+        port: z.number().int().min(1).max(65535).default(8808),
+        expose: z.boolean().default(false),
+        // When true, the player opens in the user's browser automatically when the
+        // MCP server starts (the standalone `navidrome-web` bin always opens, since
+        // the user ran it explicitly). Default false to avoid popping a tab on every
+        // headless Claude Desktop launch.
+        autoOpenBrowser: z.boolean().default(false),
+        // When true, a player spawned by the MCP server keeps running (and mpv keeps
+        // playing) after the MCP server closes/restarts. Default false: the spawned
+        // player and mpv stop with the MCP server, so nothing lingers. A player you
+        // launch yourself (`navidrome-web`) always persists regardless. Can be
+        // toggled live in the player's loopback-only settings modal.
+        persistAfterMcpExit: z.boolean().default(false),
+    }),
+});
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

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

package/dist/config/seed.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Navidrome MCP Server - Settings form seed (pre-fill source)
+ * 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 SettingsFile } from './store.js';
+/**
+ * Recommended values for the optional radio/lyrics fields that gate a feature
+ * on. Single source for two behaviours, keyed by the form's dotted field path
+ * (see `app.js` FIELDS):
+ *
+ *   - First run (no settings.json): `importFromLegacyEnv` pre-fills these into
+ *     the seed, so a fresh install gets working radio + lyrics without the user
+ *     hunting for what to type.
+ *   - Later runs (settings.json exists): the file is returned verbatim, and the
+ *     form surfaces these as non-intrusive "suggested" hints *beside* any field
+ *     the user left blank — never auto-filling, so a deliberate blank (e.g.
+ *     radio turned off) is preserved.
+ *
+ * `features.radioBrowserBase` is intentionally absent: blank there means
+ * SRV-based auto mirror selection, which is more robust than pinning a mirror.
+ */
+export declare const FORM_SUGGESTIONS: {
+    readonly 'features.radioBrowserUserAgent': "Navidrome-MCP";
+    readonly 'features.lyricsProvider': "lrclib";
+    readonly 'features.lrclibUserAgent': "Navidrome-MCP";
+    readonly 'features.lrclibBase': "https://lrclib.net";
+};
+/**
+ * Compute the seed used to pre-fill the settings form.
+ *
+ * - If a `settings.json` already exists, it IS the seed (pre-fill from the file
+ *   so the user edits what they have).
+ * - Otherwise, import a partial config from legacy sources so existing users
+ *   only have to verify + submit rather than re-type: `process.env` (covers the
+ *   MCP-client JSON env and the shell) merged with a legacy project-root `.env`
+ *   (covers dev installs). Optional radio/lyrics fields that gate a feature on
+ *   are pre-filled with working defaults (see `importFromLegacyEnv`) so a
+ *   fresh install gets functional features without hunting for values.
+ *
+ * This is import-only and never on the normal runtime path — `loadConfig()`
+ * reads `settings.json` exclusively. Returns REAL values (including secrets);
+ * masking for display happens at the HTTP layer.
+ */
+export declare function buildFormSeed(): SettingsFile;
+//# sourceMappingURL=seed.d.ts.map

package/dist/config/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/config/seed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAG7D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAM5C"}