navidrome-mcp 1.0.1

package/dist/tools/handlers/playlist-handlers.js

@@ -0,0 +1,316 @@
+import { ErrorFormatter } from '../../utils/error-formatter.js';
+// Import tool functions
+import { listPlaylists, getPlaylist, createPlaylist, updatePlaylist, deletePlaylist, getPlaylistTracks, addTracksToPlaylist, removeTracksFromPlaylist, reorderPlaylistTrack, batchAddTracksToPlaylist, } from '../playlist-management.js';
+// Tool definitions for playlist management category
+const tools = [
+    {
+        name: 'list_playlists',
+        description: 'List all playlists accessible to the user with clean, LLM-friendly data',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of playlists to return (1-500)',
+                    minimum: 1,
+                    maximum: 500,
+                    default: 100,
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of playlists to skip for pagination',
+                    minimum: 0,
+                    default: 0,
+                },
+                sort: {
+                    type: 'string',
+                    description: 'Field to sort by',
+                    default: 'name',
+                },
+                order: {
+                    type: 'string',
+                    description: 'Sort order',
+                    enum: ['ASC', 'DESC'],
+                    default: 'ASC',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_playlist',
+        description: 'Get detailed information about a specific playlist by ID',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'The unique ID of the playlist',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'create_playlist',
+        description: 'Create a new playlist with a name, optional description, and visibility setting',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    description: 'The name of the playlist',
+                },
+                comment: {
+                    type: 'string',
+                    description: 'Optional description or comment for the playlist',
+                },
+                public: {
+                    type: 'boolean',
+                    description: 'Whether the playlist should be public',
+                    default: false,
+                },
+            },
+            required: ['name'],
+        },
+    },
+    {
+        name: 'update_playlist',
+        description: 'Update a playlist\'s metadata (name, description, visibility)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'The unique ID of the playlist to update',
+                },
+                name: {
+                    type: 'string',
+                    description: 'New name for the playlist',
+                },
+                comment: {
+                    type: 'string',
+                    description: 'New description or comment',
+                },
+                public: {
+                    type: 'boolean',
+                    description: 'New public visibility setting',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'delete_playlist',
+        description: 'Delete a playlist (owner or admin only)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'The unique ID of the playlist to delete',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'get_playlist_tracks',
+        description: 'Get all tracks in a playlist (supports JSON or M3U export)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                playlistId: {
+                    type: 'string',
+                    description: 'The unique ID of the playlist',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of tracks to return (1-500)',
+                    minimum: 1,
+                    maximum: 500,
+                    default: 100,
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of tracks to skip for pagination',
+                    minimum: 0,
+                    default: 0,
+                },
+                format: {
+                    type: 'string',
+                    description: 'Output format: json for structured data, m3u for playlist file',
+                    enum: ['json', 'm3u'],
+                    default: 'json',
+                },
+            },
+            required: ['playlistId'],
+        },
+    },
+    {
+        name: 'add_tracks_to_playlist',
+        description: 'Add tracks to a playlist (supports song IDs, album IDs, artist IDs, or specific discs)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                playlistId: {
+                    type: 'string',
+                    description: 'The unique ID of the playlist',
+                },
+                ids: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of song IDs to add',
+                },
+                albumIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of album IDs to add (all tracks from albums)',
+                },
+                artistIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of artist IDs to add (all tracks from artists)',
+                },
+                discs: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            albumId: { type: 'string' },
+                            discNumber: { type: 'number' },
+                        },
+                        required: ['albumId', 'discNumber'],
+                    },
+                    description: 'Array of specific discs to add',
+                },
+            },
+            required: ['playlistId'],
+        },
+    },
+    {
+        name: 'remove_tracks_from_playlist',
+        description: 'Remove tracks from a playlist by track position IDs',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                playlistId: {
+                    type: 'string',
+                    description: 'The unique ID of the playlist',
+                },
+                trackIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of track position IDs to remove',
+                    minItems: 1,
+                },
+            },
+            required: ['playlistId', 'trackIds'],
+        },
+    },
+    {
+        name: 'reorder_playlist_track',
+        description: 'Reorder a track within a playlist to a new position',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                playlistId: {
+                    type: 'string',
+                    description: 'The unique ID of the playlist',
+                },
+                trackId: {
+                    type: 'string',
+                    description: 'The track position ID to move',
+                },
+                insert_before: {
+                    type: 'number',
+                    description: 'New position (0-based index) to insert the track before',
+                    minimum: 0,
+                },
+            },
+            required: ['playlistId', 'trackId', 'insert_before'],
+        },
+    },
+    {
+        name: 'batch_add_tracks_to_playlist',
+        description: 'Batch add multiple sets of tracks to a playlist',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                playlistId: {
+                    type: 'string',
+                    description: 'The unique ID of the playlist',
+                },
+                trackSets: {
+                    type: 'array',
+                    description: 'Array of track sets to add to the playlist',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            ids: {
+                                type: 'array',
+                                items: { type: 'string' },
+                                description: 'Array of song IDs to add',
+                            },
+                            albumIds: {
+                                type: 'array',
+                                items: { type: 'string' },
+                                description: 'Array of album IDs to add (all tracks)',
+                            },
+                            artistIds: {
+                                type: 'array',
+                                items: { type: 'string' },
+                                description: 'Array of artist IDs to add (all tracks)',
+                            },
+                            discs: {
+                                type: 'array',
+                                description: 'Array of specific discs to add',
+                                items: {
+                                    type: 'object',
+                                    properties: {
+                                        albumId: { type: 'string' },
+                                        discNumber: { type: 'number' },
+                                    },
+                                    required: ['albumId', 'discNumber'],
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            required: ['playlistId', 'trackSets'],
+        },
+    },
+];
+// Factory function for creating playlist tool category with dependencies  
+export function createPlaylistToolCategory(client, _config) {
+    return {
+        tools,
+        async handleToolCall(name, args) {
+            switch (name) {
+                case 'list_playlists':
+                    return await listPlaylists(client, args);
+                case 'get_playlist':
+                    return await getPlaylist(client, args);
+                case 'create_playlist':
+                    return await createPlaylist(client, args);
+                case 'update_playlist':
+                    return await updatePlaylist(client, args);
+                case 'delete_playlist':
+                    return await deletePlaylist(client, args);
+                case 'get_playlist_tracks':
+                    return await getPlaylistTracks(client, args);
+                case 'add_tracks_to_playlist':
+                    return await addTracksToPlaylist(client, args);
+                case 'remove_tracks_from_playlist':
+                    return await removeTracksFromPlaylist(client, args);
+                case 'reorder_playlist_track':
+                    return await reorderPlaylistTrack(client, args);
+                case 'batch_add_tracks_to_playlist':
+                    return await batchAddTracksToPlaylist(client, args);
+                default:
+                    throw new Error(ErrorFormatter.toolUnknown(`playlist ${name}`));
+            }
+        }
+    };
+}
+//# sourceMappingURL=playlist-handlers.js.map

package/dist/tools/handlers/playlist-handlers.js.map

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

package/dist/tools/handlers/queue-handlers.d.ts

@@ -0,0 +1,5 @@
+import type { NavidromeClient } from '../../client/navidrome-client.js';
+import type { Config } from '../../config.js';
+import type { ToolCategory } from './registry.js';
+export declare function createQueueToolCategory(client: NavidromeClient, _config: Config): ToolCategory;
+//# sourceMappingURL=queue-handlers.d.ts.map

package/dist/tools/handlers/queue-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-handlers.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/queue-handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AA4HlD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAoB9F"}

package/dist/tools/handlers/queue-handlers.js

@@ -0,0 +1,135 @@
+import { ErrorFormatter } from '../../utils/error-formatter.js';
+// Import tool functions
+import { getQueue, setQueue, clearQueue, } from '../queue-management.js';
+import { listRecentlyPlayed, listMostPlayed, } from '../listening-history.js';
+// Tool definitions for queue management and listening history categories
+const tools = [
+    {
+        name: 'get_queue',
+        description: 'Get the current playback queue',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'set_queue',
+        description: 'Set the playback queue with specified songs',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                songIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of song IDs to add to queue',
+                },
+                current: {
+                    type: 'number',
+                    description: 'Index of current track (0-based)',
+                    minimum: 0,
+                    default: 0,
+                },
+                position: {
+                    type: 'number',
+                    description: 'Playback position in seconds',
+                    minimum: 0,
+                    default: 0,
+                },
+            },
+            required: ['songIds'],
+        },
+    },
+    {
+        name: 'clear_queue',
+        description: 'Clear the playback queue',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'list_recently_played',
+        description: 'List recently played tracks with time filtering',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of tracks to return (1-500)',
+                    minimum: 1,
+                    maximum: 500,
+                    default: 100,
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of tracks to skip for pagination',
+                    minimum: 0,
+                    default: 0,
+                },
+                timeRange: {
+                    type: 'string',
+                    description: 'Time range for recently played tracks',
+                    enum: ['today', 'week', 'month', 'all'],
+                    default: 'all',
+                },
+            },
+        },
+    },
+    {
+        name: 'list_most_played',
+        description: 'List most played songs, albums, or artists',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                type: {
+                    type: 'string',
+                    description: 'Type of items to list',
+                    enum: ['songs', 'albums', 'artists'],
+                    default: 'songs',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of items to return (1-500)',
+                    minimum: 1,
+                    maximum: 500,
+                    default: 100,
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of items to skip for pagination',
+                    minimum: 0,
+                    default: 0,
+                },
+                minPlayCount: {
+                    type: 'number',
+                    description: 'Minimum play count to include',
+                    minimum: 1,
+                    default: 1,
+                },
+            },
+        },
+    },
+];
+// Factory function for creating queue tool category with dependencies  
+export function createQueueToolCategory(client, _config) {
+    return {
+        tools,
+        async handleToolCall(name, args) {
+            switch (name) {
+                case 'get_queue':
+                    return await getQueue(client, args);
+                case 'set_queue':
+                    return await setQueue(client, args);
+                case 'clear_queue':
+                    return await clearQueue(client, args);
+                case 'list_recently_played':
+                    return await listRecentlyPlayed(client, args);
+                case 'list_most_played':
+                    return await listMostPlayed(client, args);
+                default:
+                    throw new Error(ErrorFormatter.toolUnknown(`queue ${name}`));
+            }
+        }
+    };
+}
+//# sourceMappingURL=queue-handlers.js.map

package/dist/tools/handlers/queue-handlers.js.map

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

package/dist/tools/handlers/radio-handlers.d.ts

@@ -0,0 +1,5 @@
+import type { NavidromeClient } from '../../client/navidrome-client.js';
+import type { Config } from '../../config.js';
+import type { ToolCategory } from './registry.js';
+export declare function createRadioToolCategory(client: NavidromeClient, config: Config): ToolCategory;
+//# sourceMappingURL=radio-handlers.d.ts.map

package/dist/tools/handlers/radio-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio-handlers.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/radio-handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAuTlD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAoC7F"}