@ericdisero/aurora-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,36 @@
+# @ericdisero/aurora-mcp-server
+
+Stdio MCP server for **Aurora**, the AI audio workbench. Gives Claude (or any MCP client) full control of a local music library: generate tracks, style-transform covers, manufacture key/tempo-locked samples, split anything into 7 stems, layer the stack, export DAW-ready aligned WAVs. **27 tools.** Files land on disk in real project folders the Aurora app shows live.
+
+## Install
+
+```json
+{
+  "mcpServers": {
+    "aurora": {
+      "command": "npx",
+      "args": ["-y", "@ericdisero/aurora-mcp-server"],
+      "env": {
+        "SUNO_API_KEY": "<your sunoapi.org key>",
+        "MVSEP_API_KEY": "<your mvsep key>"
+      }
+    }
+  }
+}
+```
+
+Claude Code: `claude mcp add aurora -- npx -y @ericdisero/aurora-mcp-server`
+
+The `env` block is optional if keys are stored via the CLI (`aurora keys --suno-api-key … --mvsep-api-key …` → `~/.aurora/config.json`).
+
+## Highlights
+
+- **Standalone** — works against Aurora's database + project folders directly; the desktop app doesn't need to be running.
+- **Background jobs** — `background: true` on generate/cover/sounds/split returns a jobId; `aurora_get_job_status` polls, downloads, and registers results. Jobs survive restarts.
+- **Streaming preview** — in-flight generations expose `streamUrls`: listenable ~30-45s in, minutes before files land.
+- **Progressive stems** — splits land vocals/drums/bass stems as each separation job finishes; everything-else last.
+- **Cost discipline built in** — `aurora_get_credits` is free; destructive ops require `confirm: true`; re-splitting an already-split asset is refused.
+
+Full docs: [github.com/EricDisero/aurora-mcp](https://github.com/EricDisero/aurora-mcp). CLI sibling: `@ericdisero/aurora-cli`.
+
+MIT. Copyright Blueprint Online Learning Inc.

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/server.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+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 { zodToJsonSchema } from 'zod-to-json-schema';
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { ALL_OPERATIONS } from '@ericdisero/aurora-shared';
+// Aurora MCP server. Stdio transport. Wires every operation in
+// @ericdisero/aurora-shared as an MCP tool. Standalone — works against
+// Aurora's userData DB + project folders directly; no running app required.
+// Provider keys come from env (MCP config "env" block) or ~/.aurora/config.json
+// (written by `aurora keys set`).
+//
+//   { "command": "npx", "args": ["-y", "@ericdisero/aurora-mcp-server"],
+//     "env": { "SUNO_API_KEY": "...", "MVSEP_API_KEY": "..." } }
+const ops = ALL_OPERATIONS;
+const opsById = new Map(ops.map((o) => [o.id, o]));
+// Version comes from this package's own package.json (dist/server.js →
+// ../package.json) so the reported version never drifts from the publish.
+const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf8'));
+const server = new Server({ name: 'aurora-audio', version: pkg.version }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: ops.map((op) => ({
+        name: op.id,
+        description: op.description,
+        inputSchema: zodToJsonSchema(op.input, { target: 'openApi3' })
+    }))
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const op = opsById.get(request.params.name);
+    if (!op) {
+        return {
+            content: [{ type: 'text', text: `Unknown tool: ${request.params.name}` }],
+            isError: true
+        };
+    }
+    try {
+        const args = op.input.parse(request.params.arguments ?? {});
+        const result = await op.run(args);
+        return { content: [{ type: 'text', text: result.text }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: `Error: ${message}` }],
+            isError: true
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`[aurora-mcp] server started, ${ops.length} tools registered`);
+}
+main().catch((err) => {
+    console.error('[aurora-mcp] fatal:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@ericdisero/aurora-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for Aurora, the AI audio workbench. Your AI agent (Claude, Cursor, or any MCP client) drives music generation, covers, sample manufacturing, 7-stem separation, and DAW-ready stem organization. Files land on disk.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "aurora-mcp-server": "./dist/server.js"
+  },
+  "main": "./dist/server.js",
+  "files": ["dist", "!dist/**/*.map", "README.md"],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EricDisero/aurora-mcp.git",
+    "directory": "packages/mcp"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mcp-server",
+    "ai-music",
+    "music-generation",
+    "stem-separation",
+    "suno",
+    "mvsep",
+    "claude",
+    "claude-desktop",
+    "cursor",
+    "aurora"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@ericdisero/aurora-shared": "0.1.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.7.0"
+  }
+}