@mindstone/mcp-server-elevenlabs 0.2.2

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+export declare const REQUEST_TIMEOUT_MS = 30000;
+export interface BridgeState {
+    port: number;
+    token: string;
+}
+export declare class ElevenLabsError extends Error {
+    readonly code: string;
+    readonly resolution: string;
+    constructor(message: string, code: string, resolution: string);
+}
+export interface VoiceResult {
+    voice_id: string;
+    name: string;
+    category?: string;
+    description?: string;
+    preview_url?: string;
+    labels?: Record<string, string>;
+}
+export interface VoicesResponse {
+    voices: VoiceResult[];
+    has_more?: boolean;
+}
+export interface CompositionSection {
+    style?: string;
+    lyrics?: string;
+    duration_ms?: number;
+}
+export interface CompositionPlan {
+    positive_global_styles?: string[];
+    negative_global_styles?: string[];
+    sections?: CompositionSection[];
+}
+export interface MusicPlanResponse {
+    positive_global_styles: string[];
+    negative_global_styles: string[];
+    sections: Array<{
+        style: string;
+        lyrics: string;
+        duration_ms: number;
+    }>;
+}
+export interface TranscriptionWord {
+    text: string;
+    start: number;
+    end: number;
+    type?: string;
+}
+export interface TranscriptionResponse {
+    text: string;
+    words?: TranscriptionWord[];
+}
+export interface AudioResult {
+    filePath: string;
+    sizeBytes: number;
+}
+/**
+ * Resolve an error status code to an actionable resolution string.
+ */
+export declare function getErrorResolution(status: number, detail?: string): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -0,0 +1,34 @@
+export const REQUEST_TIMEOUT_MS = 30_000;
+export class ElevenLabsError extends Error {
+    code;
+    resolution;
+    constructor(message, code, resolution) {
+        super(message);
+        this.code = code;
+        this.resolution = resolution;
+        this.name = 'ElevenLabsError';
+    }
+}
+/**
+ * Resolve an error status code to an actionable resolution string.
+ */
+export function getErrorResolution(status, detail) {
+    const msg = (detail || '').toLowerCase();
+    if (status === 401 || msg.includes('unauthorized') || msg.includes('invalid api key')) {
+        return 'Authentication failed. Check your ElevenLabs API key in Settings. Get one at https://elevenlabs.io/app/settings/api-keys';
+    }
+    if (status === 403 || msg.includes('quota') || msg.includes('limit') || msg.includes('credits')) {
+        return 'Insufficient credits or quota exceeded. Check usage at https://elevenlabs.io/app/usage';
+    }
+    if (status === 422 || msg.includes('validation')) {
+        return 'Invalid request parameters. Check the input values and try again.';
+    }
+    if (status === 429) {
+        return 'Rate limited. Wait a moment and try again.';
+    }
+    if (msg.includes('content') || msg.includes('policy') || msg.includes('moderation')) {
+        return 'Content policy violation. Try a different prompt.';
+    }
+    return 'Please try again. If the issue persists, check your API key and credits at https://elevenlabs.io/app/settings/api-keys';
+}
+//# sourceMappingURL=types.js.map

package/dist/utils.d.ts

@@ -0,0 +1,14 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+type ToolHandler<T> = (args: T, extra: unknown) => Promise<CallToolResult>;
+/**
+ * Wraps a tool handler with standard error handling.
+ *
+ * - On success: returns the string result as a text content block.
+ * - On ElevenLabsError: returns a structured JSON error with code and resolution.
+ * - On unknown error: returns a generic error message.
+ *
+ * Secrets are never exposed in error messages.
+ */
+export declare function withErrorHandling<T>(fn: (args: T, extra: unknown) => Promise<string>): ToolHandler<T>;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.js

@@ -0,0 +1,42 @@
+import { ElevenLabsError } from './types.js';
+/**
+ * Wraps a tool handler with standard error handling.
+ *
+ * - On success: returns the string result as a text content block.
+ * - On ElevenLabsError: returns a structured JSON error with code and resolution.
+ * - On unknown error: returns a generic error message.
+ *
+ * Secrets are never exposed in error messages.
+ */
+export function withErrorHandling(fn) {
+    return async (args, extra) => {
+        try {
+            const result = await fn(args, extra);
+            return { content: [{ type: 'text', text: result }] };
+        }
+        catch (error) {
+            if (error instanceof ElevenLabsError) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                ok: false,
+                                error: error.message,
+                                code: error.code,
+                                resolution: error.resolution,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ ok: false, error: errorMessage }) }],
+                isError: true,
+            };
+        }
+    };
+}
+//# sourceMappingURL=utils.js.map

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@mindstone/mcp-server-elevenlabs",
+  "version": "0.2.2",
+  "mcpName": "io.github.mindstone/mcp-server-elevenlabs",
+  "description": "ElevenLabs MCP server for Model Context Protocol hosts \u2014 music, TTS, sound effects, voices, transcription",
+  "license": "FSL-1.1-MIT",
+  "type": "module",
+  "bin": {
+    "mcp-server-elevenlabs": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mindstone/mcp-servers.git",
+    "directory": "connectors/elevenlabs"
+  },
+  "homepage": "https://github.com/mindstone/mcp-servers/tree/main/connectors/elevenlabs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/index.js",
+    "prepare": "npm run build",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@mindstone/mcp-test-harness": "file:../../test-harness",
+    "@types/node": "^22",
+    "@vitest/coverage-v8": "^4.1.3",
+    "msw": "^2.13.2",
+    "shx": "^0.3.4",
+    "typescript": "^5.8.2",
+    "vitest": "^4.1.3"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "overrides": {
+    "fast-uri": "^3.1.2",
+    "hono": "^4.12.18",
+    "ip-address": "^10.2.0"
+  }
+}