mcp-music-studio 0.1.1 → 0.2.0

package/README.md

@@ -8,7 +8,7 @@ Forked from [`@modelcontextprotocol/server-sheet-music`](https://github.com/mode
 
 - **8 style presets** — rock, jazz, bossa, waltz, march, reggae, folk, classical. One parameter adds drums + bass + chord accompaniment.
 - **30 instruments** — selectable from UI or via tool parameter, with fuzzy matching
-- **Browser fallback** — `openInBrowser: true` launches a standalone player for CLI environments (Claude Code, Codex, Gemini CLI) that don't support ext-apps UI
+- **Three rendering modes** — ext-apps inline UI for Claude Desktop/VS Code, browser fallback for CLI environments, configurable via `--render-mode`
 - **`get-music-guide` tool** — on-demand reference for AI systems (instruments, drums, ABC syntax, arrangements, genre templates, MIDI directives)
 - **7 `music://guide/*` resources** — same content for resource-capable clients
 - **Note highlighting** — currently playing notes light up during playback
@@ -148,7 +148,6 @@ Creates and plays music with visual sheet music and multi-instrument audio.
 | `tempo` | number? | BPM (40-240) |
 | `swing` | number? | Swing feel (0-100) |
 | `transpose` | number? | Semitones (-12 to 12) |
-| `openInBrowser` | boolean? | Open standalone browser player (for CLI environments without UI) |
 
 **Example — jazz arrangement:**
 ```json
@@ -174,6 +173,31 @@ Returns reference material for composition. Topics:
 | `styles` | What each style preset does and when to use it |
 | `midi-directives` | Full `%%MIDI` reference for ABCJS |
 
+## Render Modes
+
+The server auto-detects whether the client supports ext-apps UI. For clients that don't, use `--render-mode` to control how music is delivered:
+
+| Mode | Flag | Behavior |
+|------|------|----------|
+| `auto` | (default) | Inline ext-apps UI for Claude Desktop, VS Code |
+| `browser` | `--render-mode browser` | Saves HTML player and opens in system browser |
+| `html` | `--render-mode html` | Returns HTML as embedded resource in response |
+
+Use `--output-dir` to control where HTML player files are saved (default: `~/Desktop/mcp-music-studio`).
+
+**Example — Cherry Studio, CLI environments, or other non-ext-apps clients:**
+
+```json
+{
+  "mcpServers": {
+    "music-studio": {
+      "command": "npx",
+      "args": ["-y", "mcp-music-studio", "--stdio", "--render-mode", "browser", "--output-dir", "/path/to/output"]
+    }
+  }
+}
+```
+
 ## Development
 
 ```bash

package/dist/.assetsignore

@@ -0,0 +1,2 @@
+wrangler.json
+.dev.vars

package/dist/index.js

@@ -19630,7 +19630,7 @@ var require_is_promise = __commonJS((exports, module) => {
   }
 });
 
-// node_modules/path-to-regexp/dist/index.js
+// node_modules/router/node_modules/path-to-regexp/dist/index.js
 var require_dist = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.PathError = exports.TokenData = undefined;
@@ -30624,13 +30624,13 @@ async function startStreamableHTTPServer(createServer2) {
       }
     }
   });
-  const httpServer = app.listen(port, (err) => {
-    if (err) {
-      console.error("Failed to start server:", err);
-      process.exit(1);
-    }
+  const httpServer = app.listen(port, () => {
     console.log(`MCP server listening on http://localhost:${port}/mcp`);
   });
+  httpServer.on("error", (err) => {
+    console.error("Failed to start server:", err);
+    process.exit(1);
+  });
   const shutdown = () => {
     console.log(`
 Shutting down...`);
@@ -30642,11 +30642,38 @@ Shutting down...`);
 async function startStdioServer(createServer2) {
   await createServer2().connect(new StdioServerTransport);
 }
+function parseArg(name) {
+  for (let i = 0;i < process.argv.length; i++) {
+    const arg = process.argv[i].trim();
+    if (arg === name && i + 1 < process.argv.length)
+      return process.argv[i + 1].trim();
+    if (arg.startsWith(name + "="))
+      return arg.slice(name.length + 1).trim();
+    if (arg.startsWith(name + " "))
+      return arg.slice(name.length).trim();
+  }
+  return;
+}
+function parseRenderMode() {
+  const val = parseArg("--render-mode");
+  if (!val)
+    return "auto";
+  if (val === "html" || val === "browser" || val === "auto")
+    return val;
+  console.error(`Unknown render mode "${val}", using "auto"`);
+  return "auto";
+}
+function parseOutputDir() {
+  return parseArg("--output-dir");
+}
 async function main() {
+  const defaultRenderMode = parseRenderMode();
+  const outputDir = parseOutputDir();
+  const factory = () => createServer({ defaultRenderMode, outputDir });
   if (process.argv.includes("--stdio")) {
-    await startStdioServer(createServer);
+    await startStdioServer(factory);
   } else {
-    await startStreamableHTTPServer(createServer);
+    await startStreamableHTTPServer(factory);
   }
 }
 main().catch((e) => {