@darrenjaws/spotify-mcp 0.1.0

package/build/tools/search.js

@@ -0,0 +1,62 @@
+/**
+ * Search tools
+ */
+import { getAuthenticatedClient } from "../spotify/client.js";
+export async function search(args) {
+    const client = await getAuthenticatedClient();
+    const limit = args.limit || 10;
+    const result = await client.search(args.query, [args.type], { limit });
+    let items = [];
+    let itemType = "";
+    switch (args.type) {
+        case "track":
+            items = result.body.tracks?.items || [];
+            itemType = "tracks";
+            break;
+        case "album":
+            items = result.body.albums?.items || [];
+            itemType = "albums";
+            break;
+        case "artist":
+            items = result.body.artists?.items || [];
+            itemType = "artists";
+            break;
+        case "playlist":
+            items = result.body.playlists?.items || [];
+            itemType = "playlists";
+            break;
+    }
+    if (items.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `No ${itemType} found for query: "${args.query}"`,
+                },
+            ],
+        };
+    }
+    const formatted = items.map((item, index) => {
+        switch (args.type) {
+            case "track":
+                return `${index + 1}. ${item.name} - ${item.artists.map((a) => a.name).join(", ")} (${item.uri})`;
+            case "album":
+                return `${index + 1}. ${item.name} - ${item.artists.map((a) => a.name).join(", ")} (${item.uri})`;
+            case "artist":
+                return `${index + 1}. ${item.name} (${item.uri})`;
+            case "playlist":
+                return `${index + 1}. ${item.name} - ${item.owner.display_name} (${item.tracks.total} tracks) (${item.uri})`;
+            default:
+                return `${index + 1}. ${item.name}`;
+        }
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Found ${items.length} ${itemType} for "${args.query}":\n\n${formatted.join("\n")}`,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=search.js.map

package/build/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAgB;IAC3C,MAAM,MAAM,GAAG,MAAM,sBAAsB,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAE/B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAEvE,IAAI,KAAK,GAAU,EAAE,CAAC;IACtB,IAAI,QAAQ,GAAG,EAAE,CAAC;IAElB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,OAAO;YACV,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;YACxC,QAAQ,GAAG,QAAQ,CAAC;YACpB,MAAM;QACR,KAAK,OAAO;YACV,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;YACxC,QAAQ,GAAG,QAAQ,CAAC;YACpB,MAAM;QACR,KAAK,QAAQ;YACX,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;YACzC,QAAQ,GAAG,SAAS,CAAC;YACrB,MAAM;QACR,KAAK,UAAU;YACb,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC;YAC3C,QAAQ,GAAG,WAAW,CAAC;YACvB,MAAM;IACV,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM,QAAQ,sBAAsB,IAAI,CAAC,KAAK,GAAG;iBACxD;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC1C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,OAAO;gBACV,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC;YACzG,KAAK,OAAO;gBACV,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC;YACzG,KAAK,QAAQ;gBACX,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC;YACpD,KAAK,UAAU;gBACb,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,aAAa,IAAI,CAAC,GAAG,GAAG,CAAC;YAC/G;gBACE,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,SAAS,KAAK,CAAC,MAAM,IAAI,QAAQ,SAAS,IAAI,CAAC,KAAK,SAAS,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC1F;SACF;KACF,CAAC;AACJ,CAAC"}

package/build/tools/user.d.ts

@@ -0,0 +1,8 @@
+/**
+ * User data tools
+ */
+import type { ToolResponse, TopItemsArgs, RecentlyPlayedArgs } from "../types.js";
+export declare function getUserProfile(): Promise<ToolResponse>;
+export declare function getTopItems(args: TopItemsArgs): Promise<ToolResponse>;
+export declare function getRecentlyPlayed(args: RecentlyPlayedArgs): Promise<ToolResponse>;
+//# sourceMappingURL=user.d.ts.map

package/build/tools/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/tools/user.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAElF,wBAAsB,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC,CAsB5D;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAoD3E;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAgCvF"}

package/build/tools/user.js

@@ -0,0 +1,103 @@
+/**
+ * User data tools
+ */
+import { getAuthenticatedClient } from "../spotify/client.js";
+export async function getUserProfile() {
+    const client = await getAuthenticatedClient();
+    const result = await client.getMe();
+    const user = result.body;
+    const text = `User Profile:
+Name: ${user.display_name || "N/A"}
+Email: ${user.email || "N/A"}
+Country: ${user.country || "N/A"}
+Product: ${user.product || "N/A"}
+Followers: ${user.followers?.total || 0}
+User ID: ${user.id}`;
+    return {
+        content: [
+            {
+                type: "text",
+                text,
+            },
+        ],
+    };
+}
+export async function getTopItems(args) {
+    const client = await getAuthenticatedClient();
+    const limit = args.limit || 20;
+    const timeRange = args.time_range || "medium_term";
+    let result;
+    let items = [];
+    let itemType = "";
+    if (args.type === "artists") {
+        result = await client.getMyTopArtists({ limit, time_range: timeRange });
+        items = result.body.items;
+        itemType = "artists";
+    }
+    else {
+        result = await client.getMyTopTracks({ limit, time_range: timeRange });
+        items = result.body.items;
+        itemType = "tracks";
+    }
+    if (items.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `No top ${itemType} found`,
+                },
+            ],
+        };
+    }
+    const timeRangeText = {
+        short_term: "last 4 weeks",
+        medium_term: "last 6 months",
+        long_term: "all time",
+    }[timeRange];
+    const formatted = items.map((item, index) => {
+        if (args.type === "artists") {
+            return `${index + 1}. ${item.name} (${item.genres.slice(0, 2).join(", ")})`;
+        }
+        else {
+            return `${index + 1}. ${item.name} - ${item.artists.map((a) => a.name).join(", ")}`;
+        }
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Your top ${itemType} (${timeRangeText}):\n\n${formatted.join("\n")}`,
+            },
+        ],
+    };
+}
+export async function getRecentlyPlayed(args) {
+    const client = await getAuthenticatedClient();
+    const limit = args.limit || 20;
+    const result = await client.getMyRecentlyPlayedTracks({ limit });
+    const items = result.body.items;
+    if (items.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "No recently played tracks found",
+                },
+            ],
+        };
+    }
+    const formatted = items.map((item, index) => {
+        const track = item.track;
+        const playedAt = new Date(item.played_at).toLocaleString();
+        return `${index + 1}. ${track.name} - ${track.artists.map((a) => a.name).join(", ")} (${playedAt})`;
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Recently played tracks:\n\n${formatted.join("\n")}`,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=user.js.map

package/build/tools/user.js.map

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

package/build/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Type definitions for Spotify MCP server
+ */
+export interface SpotifyCredentials {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+}
+export interface StoredTokens {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+}
+export interface ToolResponse {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export interface PlaybackArgs {
+    uri?: string;
+    uris?: string[];
+    device_id?: string;
+}
+export interface SearchArgs {
+    query: string;
+    type: "track" | "album" | "artist" | "playlist";
+    limit?: number;
+}
+export interface CreatePlaylistArgs {
+    name: string;
+    description?: string;
+    public?: boolean;
+}
+export interface AddToPlaylistArgs {
+    playlist_id: string;
+    uris: string[];
+    position?: number;
+}
+export interface GetPlaylistArgs {
+    playlist_id: string;
+}
+export interface VolumeArgs {
+    volume_percent: number;
+    device_id?: string;
+}
+export interface TopItemsArgs {
+    type: "artists" | "tracks";
+    time_range?: "short_term" | "medium_term" | "long_term";
+    limit?: number;
+}
+export interface RecentlyPlayedArgs {
+    limit?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,UAAU,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,WAAW,CAAC;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/build/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for Spotify MCP server
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/build/utils/logger.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Simple logging utility
+ * Logs to stderr to avoid interfering with stdio transport
+ * Automatically redacts sensitive data (tokens, secrets, passwords)
+ */
+export declare const logger: {
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/build/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuEH,eAAO,MAAM,MAAM;mBACF,MAAM,WAAW,GAAG,EAAE;kBAMvB,MAAM,WAAW,GAAG,EAAE;kBAMtB,MAAM,WAAW,GAAG,EAAE;mBAMrB,MAAM,WAAW,GAAG,EAAE;CAKtC,CAAC"}

package/build/utils/logger.js

@@ -0,0 +1,86 @@
+/**
+ * Simple logging utility
+ * Logs to stderr to avoid interfering with stdio transport
+ * Automatically redacts sensitive data (tokens, secrets, passwords)
+ */
+const LOG_LEVEL = process.env.LOG_LEVEL || "info";
+const levels = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+// Sensitive field names that should be redacted
+const SENSITIVE_FIELDS = [
+    'token', 'accessToken', 'refreshToken', 'access_token', 'refresh_token',
+    'secret', 'clientSecret', 'client_secret', 'password', 'apiKey', 'api_key',
+    'authorization', 'auth', 'bearer'
+];
+/**
+ * Recursively redact sensitive fields from objects
+ */
+function redactSensitiveData(obj) {
+    if (obj === null || obj === undefined) {
+        return obj;
+    }
+    if (typeof obj === 'string') {
+        // Redact if string looks like a token (long alphanumeric strings)
+        if (obj.length > 20 && /^[A-Za-z0-9_-]+$/.test(obj)) {
+            return '[REDACTED]';
+        }
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(item => redactSensitiveData(item));
+    }
+    if (typeof obj === 'object') {
+        const redacted = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (SENSITIVE_FIELDS.some(field => key.toLowerCase().includes(field.toLowerCase()))) {
+                redacted[key] = '[REDACTED]';
+            }
+            else {
+                redacted[key] = redactSensitiveData(value);
+            }
+        }
+        return redacted;
+    }
+    return obj;
+}
+function shouldLog(level) {
+    return levels[level] >= levels[LOG_LEVEL];
+}
+function formatMessage(level, message, ...args) {
+    const timestamp = new Date().toISOString();
+    const formattedArgs = args.length > 0 ? " " + args.map(arg => {
+        if (typeof arg === "object") {
+            const redacted = redactSensitiveData(arg);
+            return JSON.stringify(redacted);
+        }
+        return String(arg);
+    }).join(" ") : "";
+    return `[${timestamp}] [${level.toUpperCase()}] ${message}${formattedArgs}`;
+}
+export const logger = {
+    debug(message, ...args) {
+        if (shouldLog("debug")) {
+            console.error(formatMessage("debug", message, ...args));
+        }
+    },
+    info(message, ...args) {
+        if (shouldLog("info")) {
+            console.error(formatMessage("info", message, ...args));
+        }
+    },
+    warn(message, ...args) {
+        if (shouldLog("warn")) {
+            console.error(formatMessage("warn", message, ...args));
+        }
+    },
+    error(message, ...args) {
+        if (shouldLog("error")) {
+            console.error(formatMessage("error", message, ...args));
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

package/build/utils/logger.js.map

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

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@darrenjaws/spotify-mcp",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server for Spotify integration",
+  "type": "module",
+  "bin": {
+    "spotify-mcp": "build/bin.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x build/bin.js",
+    "dev": "tsc --watch",
+    "clean": "rm -rf build",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build && npm test",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "spotify",
+    "music",
+    "ai",
+    "claude"
+  ],
+  "author": "Darren Jaworski <darrenjaworski@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/darrenjaworski/spotify-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/darrenjaworski/spotify-mcp/issues"
+  },
+  "homepage": "https://github.com/darrenjaworski/spotify-mcp#readme",
+  "files": [
+    "build/**/*.js",
+    "build/**/*.d.ts",
+    "build/**/*.js.map",
+    "build/**/*.d.ts.map",
+    "!build/**/*.test.js",
+    "!build/**/*.test.d.ts",
+    "!build/**/*.test.js.map",
+    "!build/**/*.test.d.ts.map",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "dotenv": "^16.4.7",
+    "spotify-web-api-node": "^5.0.2",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@types/spotify-web-api-node": "^5.0.11",
+    "@typescript-eslint/eslint-plugin": "^8.19.1",
+    "@typescript-eslint/parser": "^8.19.1",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^9.17.0",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}