cronygen-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,88 @@
+# CronyGen MCP Server
+
+Model Context Protocol server for CronyGen Text-to-Speech.
+
+## Installation
+
+```bash
+npm install -g @cronygen/mcp-server
+```
+
+## Configuration
+
+Set your API key:
+
+```bash
+export CRONYGEN_API_KEY="crony_sk_your_api_key"
+```
+
+## Usage with Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "cronygen": {
+      "command": "cronygen-mcp",
+      "env": {
+        "CRONYGEN_API_KEY": "crony_sk_your_api_key"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### generate_speech
+
+Generate speech audio from text. Supports default and cloned voices.
+
+```
+Generate speech for: "Hello, this is a test of CronyGen TTS."
+```
+
+### list_voices
+
+List available default and cloned voices.
+
+```
+List all available voices for TTS.
+```
+
+### get_generation
+
+Get details about a previous generation.
+
+### list_generations
+
+List previous TTS generations with pagination.
+
+### delete_generation
+
+Delete a TTS generation by ID.
+
+### get_billing
+
+Check credits balance and usage.
+
+### get_user
+
+Get current authenticated user profile.
+
+## Examples
+
+```
+User: Generate speech saying "Welcome to CronyGen" and save it to ~/Desktop/welcome.wav
+
+Claude: I'll generate that speech for you using CronyGen TTS.
+
+[Uses generate_speech tool]
+
+Audio generated and saved to /Users/you/Desktop/welcome.wav (duration: 2.3s)
+```
+
+## Documentation
+
+Full documentation at [zingotron.com/docs/mcp](https://zingotron.com/docs/mcp)

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * CronyGen MCP Server
+ *
+ * Model Context Protocol server exposing CronyGen TTS as tools.
+ * Allows AI agents to generate speech, manage voices, and check billing.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,327 @@
+#!/usr/bin/env node
+/**
+ * CronyGen MCP Server
+ *
+ * Model Context Protocol server exposing CronyGen TTS as tools.
+ * Allows AI agents to generate speech, manage voices, and check billing.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import * as fs from "fs";
+import * as path from "path";
+const API_BASE = process.env.CRONYGEN_API_URL || "https://api.zingotron.com";
+const API_KEY = process.env.CRONYGEN_API_KEY || "";
+// ============================================================================
+// API Client
+// ============================================================================
+async function apiRequest(method, endpoint, body) {
+    const response = await fetch(`${API_BASE}${endpoint}`, {
+        method,
+        headers: {
+            Authorization: API_KEY.startsWith('crony_sk_') ? API_KEY : `Bearer ${API_KEY}`,
+            "Content-Type": "application/json",
+        },
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    const data = (await response.json());
+    if (!response.ok || !data.success) {
+        throw new Error(data.error?.message || `API request failed: ${response.status}`);
+    }
+    return data.data;
+}
+async function pollGeneration(generationId, timeoutMs = 300000) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+        const result = (await apiRequest("GET", `/v1/tts/jobs/${generationId}`));
+        if (result.status === "completed") {
+            return result;
+        }
+        if (result.status === "failed") {
+            throw new Error(result.error_message || "Generation failed");
+        }
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+    }
+    throw new Error("Generation timed out");
+}
+// Helper: detect if a voice string looks like a UUID (cloned voice)
+function isUUID(str) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(str);
+}
+// ============================================================================
+// Tool Definitions
+// ============================================================================
+const TOOLS = [
+    {
+        name: "generate_speech",
+        description: "Generate speech audio from text using CronyGen TTS. Returns the URL of the generated audio file.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                text: {
+                    type: "string",
+                    description: "The text to convert to speech",
+                },
+                voice: {
+                    type: "string",
+                    description: "Voice ID or slug. Use a slug like 'en-us-aria' for default voices, or a UUID for cloned voices.",
+                    default: "en-us-aria",
+                },
+                output_path: {
+                    type: "string",
+                    description: "Optional local path to save the audio file",
+                },
+            },
+            required: ["text"],
+        },
+    },
+    {
+        name: "list_voices",
+        description: "List available voices including default system voices and user's cloned voices",
+        inputSchema: {
+            type: "object",
+            properties: {
+                type: {
+                    type: "string",
+                    enum: ["all", "default", "cloned"],
+                    description: "Filter by voice type",
+                    default: "all",
+                },
+            },
+        },
+    },
+    {
+        name: "get_generation",
+        description: "Get details about a previous TTS generation",
+        inputSchema: {
+            type: "object",
+            properties: {
+                generation_id: {
+                    type: "string",
+                    description: "The ID of the generation to retrieve",
+                },
+            },
+            required: ["generation_id"],
+        },
+    },
+    {
+        name: "list_generations",
+        description: "List previous TTS generations with pagination",
+        inputSchema: {
+            type: "object",
+            properties: {
+                page: {
+                    type: "number",
+                    description: "Page number (default: 1)",
+                    default: 1,
+                },
+                limit: {
+                    type: "number",
+                    description: "Results per page (default: 20)",
+                    default: 20,
+                },
+            },
+        },
+    },
+    {
+        name: "delete_generation",
+        description: "Delete a TTS generation by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                generation_id: {
+                    type: "string",
+                    description: "The ID of the generation to delete",
+                },
+            },
+            required: ["generation_id"],
+        },
+    },
+    {
+        name: "get_billing",
+        description: "Get current billing information including credits balance and usage",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "get_user",
+        description: "Get current authenticated user profile",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+];
+// ============================================================================
+// Tool Handlers
+// ============================================================================
+async function handleGenerateSpeech(args) {
+    if (!args.text) {
+        throw new Error("text is required");
+    }
+    const voice = args.voice || "en-us-aria";
+    // Start generation
+    const result = (await apiRequest("POST", "/v1/tts/generate", {
+        text: args.text,
+        voice,
+        voice_type: isUUID(voice) ? "cloned" : "default",
+    }));
+    // Wait for completion
+    const generation = (await pollGeneration(result.generation_id));
+    // Optionally save to file
+    if (args.output_path) {
+        const audioResponse = await fetch(generation.output_audio_url);
+        const audioBuffer = await audioResponse.arrayBuffer();
+        const outputPath = path.resolve(args.output_path);
+        fs.writeFileSync(outputPath, Buffer.from(audioBuffer));
+        return `Audio generated and saved to ${outputPath} (duration: ${generation.output_duration_seconds.toFixed(1)}s)`;
+    }
+    return `Audio generated: ${generation.output_audio_url} (duration: ${generation.output_duration_seconds.toFixed(1)}s)`;
+}
+async function handleListVoices(args) {
+    const type = args.type || "all";
+    const voices = [];
+    if (type === "all" || type === "default") {
+        const defaults = (await apiRequest("GET", "/v1/voices/defaults"));
+        voices.push("## Default Voices\n");
+        if (Array.isArray(defaults)) {
+            for (const v of defaults) {
+                voices.push(`- **${v.name}** (${v.slug}) - ${v.gender}, ${v.accent}`);
+            }
+        }
+    }
+    if (type === "all" || type === "cloned") {
+        const response = (await apiRequest("GET", "/v1/voices"));
+        // API may return array directly or wrapped in {data: [...]}
+        const cloned = Array.isArray(response) ? response : response.data || [];
+        if (cloned.length > 0) {
+            voices.push("\n## Your Cloned Voices\n");
+            for (const v of cloned) {
+                voices.push(`- **${v.name}** (${v.id}) - ${v.status}`);
+            }
+        }
+    }
+    return voices.join("\n") || "No voices found.";
+}
+async function handleGetGeneration(args) {
+    const gen = (await apiRequest("GET", `/v1/tts/jobs/${args.generation_id}`));
+    return `Generation ${gen.id}:
+- Status: ${gen.status}
+- Input: ${gen.input_text_length} characters
+- Duration: ${gen.output_duration_seconds?.toFixed(1) || "N/A"}s
+- Cost: ${gen.cost_credits || "N/A"} credits
+- Audio: ${gen.output_audio_url || "Not ready"}
+- Created: ${gen.created_at}`;
+}
+async function handleListGenerations(args) {
+    const page = args.page || 1;
+    const limit = args.limit || 20;
+    const response = (await apiRequest("GET", `/v1/tts/generations?page=${page}&limit=${limit}`));
+    const gens = Array.isArray(response) ? response : [];
+    if (gens.length === 0) {
+        return "No generations found.";
+    }
+    const lines = [`## Generations (page ${page})\n`];
+    for (const gen of gens) {
+        lines.push(`- **${gen.id}** — ${gen.status} | ${gen.input_text_length} chars | ${gen.output_duration_seconds?.toFixed(1) || "?"}s | ${gen.created_at}`);
+    }
+    return lines.join("\n");
+}
+async function handleDeleteGeneration(args) {
+    await apiRequest("DELETE", `/v1/tts/generations/${args.generation_id}`);
+    return `Generation ${args.generation_id} deleted.`;
+}
+async function handleGetBilling() {
+    const billing = (await apiRequest("GET", "/v1/billing"));
+    return `Billing Account:
+- Credits Balance: ${billing.credits_balance.toFixed(2)}
+- Tier: ${billing.tier}
+
+This Month's Usage:
+- Generations: ${billing.usage_this_month.generations}
+- Credits Used: ${billing.usage_this_month.credits_used.toFixed(2)}
+- Minutes Generated: ${billing.usage_this_month.minutes_generated.toFixed(1)}`;
+}
+async function handleGetUser() {
+    const user = (await apiRequest("GET", "/v1/me"));
+    return `User Profile:
+- Email: ${user.email}
+- Name: ${user.name || "N/A"}
+- Tier: ${user.tier}
+- Verified: ${user.email_verified}
+- Created: ${user.created_at}`;
+}
+// ============================================================================
+// Server Setup
+// ============================================================================
+const server = new Server({
+    name: "cronygen-mcp",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: TOOLS };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        let result;
+        switch (name) {
+            case "generate_speech":
+                result = await handleGenerateSpeech(args);
+                break;
+            case "list_voices":
+                result = await handleListVoices(args);
+                break;
+            case "get_generation":
+                result = await handleGetGeneration(args);
+                break;
+            case "list_generations":
+                result = await handleListGenerations(args);
+                break;
+            case "delete_generation":
+                result = await handleDeleteGeneration(args);
+                break;
+            case "get_billing":
+                result = await handleGetBilling();
+                break;
+            case "get_user":
+                result = await handleGetUser();
+                break;
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+        return {
+            content: [{ type: "text", text: result }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    if (!API_KEY) {
+        console.error("Error: CRONYGEN_API_KEY environment variable is required");
+        process.exit(1);
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("CronyGen MCP server running on stdio");
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,41 @@
+{
+    "name": "cronygen-mcp-server",
+    "version": "1.0.0",
+    "description": "Model Context Protocol server for CronyGen Text-to-Speech",
+    "type": "module",
+    "main": "dist/index.js",
+    "bin": {
+        "cronygen-mcp": "./dist/index.js"
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "prepublishOnly": "npm run build",
+        "start": "node dist/index.js"
+    },
+    "keywords": [
+        "mcp",
+        "model-context-protocol",
+        "tts",
+        "text-to-speech",
+        "cronygen",
+        "ai",
+        "voice"
+    ],
+    "author": "CronyGen <support@zingotron.com>",
+    "license": "MIT",
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^0.5.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.10.0",
+        "typescript": "^5.3.3"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}