navidrome-mcp 1.0.1

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

@@ -0,0 +1,155 @@
+// Import tool functions
+import { listTags, getTag, searchByTags, getTagDistribution, listUniqueTags, } from '../tags.js';
+// Tool definitions for tags category
+const tools = [
+    {
+        name: 'list_tags',
+        description: 'List all metadata tags with optional filtering by tag name and pagination',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of tags to return (1-500)',
+                    minimum: 1,
+                    maximum: 500,
+                    default: 100,
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of tags to skip for pagination',
+                    minimum: 0,
+                    default: 0,
+                },
+                sort: {
+                    type: 'string',
+                    description: 'Field to sort by',
+                    enum: ['tagName', 'tagValue', 'albumCount', 'songCount'],
+                    default: 'tagName',
+                },
+                order: {
+                    type: 'string',
+                    description: 'Sort order',
+                    enum: ['ASC', 'DESC'],
+                    default: 'ASC',
+                },
+                tagName: {
+                    type: 'string',
+                    description: 'Filter by specific tag name (e.g., "genre", "composer", "label")',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_tag',
+        description: 'Get detailed information about a specific tag by ID',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'The unique ID of the tag',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'search_by_tags',
+        description: 'Search for songs/albums by specific tag criteria (e.g., find all songs with genre "Jazz" or composer "Bach")',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                tagName: {
+                    type: 'string',
+                    description: 'Tag name to search by (e.g., "genre", "composer", "label")',
+                },
+                tagValue: {
+                    type: 'string',
+                    description: 'Optional tag value to match exactly',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of matching tags to return',
+                    minimum: 1,
+                    maximum: 100,
+                    default: 100,
+                },
+            },
+            required: ['tagName'],
+        },
+    },
+    {
+        name: 'get_tag_distribution',
+        description: 'Analyze tag usage patterns and distribution across the music library',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                tagNames: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Specific tag names to analyze (if omitted, analyzes all)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of tag names to analyze',
+                    minimum: 1,
+                    maximum: 50,
+                    default: 10,
+                },
+                distributionLimit: {
+                    type: 'number',
+                    description: 'Maximum number of tag values to show in distribution (prevents huge output)',
+                    minimum: 1,
+                    maximum: 100,
+                    default: 20,
+                },
+            },
+        },
+    },
+    {
+        name: 'list_unique_tags',
+        description: 'List all unique tag names with statistics (how many unique values, total usage)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of tag names to return',
+                    minimum: 1,
+                    maximum: 100,
+                    default: 100,
+                },
+                minUsage: {
+                    type: 'number',
+                    description: 'Minimum song count to include a tag name',
+                    minimum: 1,
+                    default: 1,
+                },
+            },
+        },
+    },
+];
+// Factory function for creating tags tool category with dependencies  
+export function createTagsToolCategory(client, _config) {
+    return {
+        tools,
+        async handleToolCall(name, args) {
+            switch (name) {
+                case 'list_tags':
+                    return await listTags(client, args);
+                case 'get_tag':
+                    return await getTag(client, args);
+                case 'search_by_tags':
+                    return await searchByTags(client, args);
+                case 'get_tag_distribution':
+                    return await getTagDistribution(client, args);
+                case 'list_unique_tags':
+                    return await listUniqueTags(client, args);
+                default:
+                    throw new Error(`Unknown tags tool: ${name}`);
+            }
+        }
+    };
+}
+//# sourceMappingURL=tag-handlers.js.map

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

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

package/dist/tools/handlers/user-preferences-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 createUserPreferencesToolCategory(client: NavidromeClient, config: Config): ToolCategory;
+//# sourceMappingURL=user-preferences-handlers.d.ts.map

package/dist/tools/handlers/user-preferences-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-preferences-handlers.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/user-preferences-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;AA+IlD,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAoBvG"}

package/dist/tools/handlers/user-preferences-handlers.js

@@ -0,0 +1,155 @@
+import { ErrorFormatter } from '../../utils/error-formatter.js';
+// Import tool functions
+import { starItem, unstarItem, setRating, listStarredItems, listTopRated, } from '../user-preferences.js';
+// Tool definitions for user preferences category
+const tools = [
+    {
+        name: 'star_item',
+        description: 'Star/favorite a song, album, or artist',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'The unique ID of the item to star',
+                },
+                type: {
+                    type: 'string',
+                    description: 'The type of item to star',
+                    enum: ['song', 'album', 'artist'],
+                },
+            },
+            required: ['id', 'type'],
+        },
+    },
+    {
+        name: 'unstar_item',
+        description: 'Unstar/unfavorite a song, album, or artist',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'The unique ID of the item to unstar',
+                },
+                type: {
+                    type: 'string',
+                    description: 'The type of item to unstar',
+                    enum: ['song', 'album', 'artist'],
+                },
+            },
+            required: ['id', 'type'],
+        },
+    },
+    {
+        name: 'set_rating',
+        description: 'Set a rating (0-5 stars) for a song, album, or artist',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'The unique ID of the item to rate',
+                },
+                type: {
+                    type: 'string',
+                    description: 'The type of item to rate',
+                    enum: ['song', 'album', 'artist'],
+                },
+                rating: {
+                    type: 'number',
+                    description: 'Rating from 0-5 stars (0 removes rating)',
+                    minimum: 0,
+                    maximum: 5,
+                },
+            },
+            required: ['id', 'type', 'rating'],
+        },
+    },
+    {
+        name: 'list_starred_items',
+        description: 'List starred/favorited songs, albums, or artists',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                type: {
+                    type: 'string',
+                    description: 'Type of starred items to list',
+                    enum: ['songs', 'albums', 'artists'],
+                },
+                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,
+                },
+            },
+            required: ['type'],
+        },
+    },
+    {
+        name: 'list_top_rated',
+        description: 'List top-rated songs, albums, or artists',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                type: {
+                    type: 'string',
+                    description: 'Type of items to list',
+                    enum: ['songs', 'albums', 'artists'],
+                },
+                minRating: {
+                    type: 'number',
+                    description: 'Minimum rating to include (1-5)',
+                    minimum: 1,
+                    maximum: 5,
+                    default: 4,
+                },
+                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,
+                },
+            },
+            required: ['type'],
+        },
+    },
+];
+// Factory function for creating user preferences tool category with dependencies  
+export function createUserPreferencesToolCategory(client, config) {
+    return {
+        tools,
+        async handleToolCall(name, args) {
+            switch (name) {
+                case 'star_item':
+                    return await starItem(client, config, args);
+                case 'unstar_item':
+                    return await unstarItem(client, config, args);
+                case 'set_rating':
+                    return await setRating(client, config, args);
+                case 'list_starred_items':
+                    return await listStarredItems(client, args);
+                case 'list_top_rated':
+                    return await listTopRated(client, args);
+                default:
+                    throw new Error(ErrorFormatter.toolUnknown(`user preference ${name}`));
+            }
+        }
+    };
+}
+//# sourceMappingURL=user-preferences-handlers.js.map

package/dist/tools/handlers/user-preferences-handlers.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Navidrome MCP Server - Tool Registry
+ * 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/>.
+ */
+export { registerTools, createToolResponse } from './handlers/registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,20 @@
+/**
+ * Navidrome MCP Server - Tool Registry
+ * 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/>.
+ */
+// Re-export the coordinated registry system
+export { registerTools, createToolResponse } from './handlers/registry.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,4CAA4C;AAC5C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/tools/lastfm-discovery.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Navidrome MCP Server - Last.fm Music Discovery 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 { Config } from '../config.js';
+export interface LastFmArtist {
+    name: string;
+    match: number;
+    url: string;
+    mbid: string | null;
+}
+export interface SimilarArtistsResult {
+    artist: string;
+    count: number;
+    similarArtists: LastFmArtist[];
+}
+export interface LastFmTrack {
+    name: string;
+    artist: string;
+    match: number;
+    url: string;
+    mbid: string | null;
+}
+export interface SimilarTracksResult {
+    originalTrack: {
+        artist: string;
+        track: string;
+    };
+    count: number;
+    similarTracks: LastFmTrack[];
+}
+export interface LastFmTag {
+    name: string;
+    url: string;
+}
+export interface ArtistInfoResult {
+    name: string;
+    mbid: string | null;
+    url: string;
+    listeners: number;
+    playcount: number;
+    biography: string | null;
+    tags: LastFmTag[];
+    similar: string[];
+}
+export interface TopTrackResult {
+    rank: number;
+    name: string;
+    playcount: number;
+    listeners: number;
+    url: string;
+    mbid: string | null;
+}
+export interface TopTracksByArtistResult {
+    artist: string;
+    count: number;
+    tracks: TopTrackResult[];
+}
+export interface TrendingArtistItem {
+    rank: number;
+    name: string;
+    playcount: number;
+    listeners: number;
+    url: string;
+    mbid: string | null;
+}
+export interface TrendingTrackItem {
+    rank: number;
+    name: string;
+    artist: string;
+    playcount: number;
+    listeners: number;
+    url: string;
+    mbid: string | null;
+}
+export interface TrendingTagItem {
+    rank: number;
+    name: string;
+    count: number;
+    url: string;
+}
+export interface TrendingMusicResult {
+    type: string;
+    page: number;
+    perPage: number;
+    count: number;
+    items: TrendingArtistItem[] | TrendingTrackItem[] | TrendingTagItem[];
+}
+export declare function getSimilarArtists(config: Config, args: unknown): Promise<SimilarArtistsResult>;
+export declare function getSimilarTracks(config: Config, args: unknown): Promise<SimilarTracksResult>;
+export declare function getArtistInfo(config: Config, args: unknown): Promise<ArtistInfoResult>;
+export declare function getTopTracksByArtist(config: Config, args: unknown): Promise<TopTracksByArtistResult>;
+export declare function getTrendingMusic(config: Config, args: unknown): Promise<TrendingMusicResult>;
+//# sourceMappingURL=lastfm-discovery.d.ts.map

package/dist/tools/lastfm-discovery.d.ts.map

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