moosetracker-mcp 0.0.0-stage → 1.2.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kurtis Alexander
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# moosetracker-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+This package is the local stdio-to-remote bridge only. The product and setup pages are at https://moosetracker.app/ and https://moosetracker.app/ai.
+
+A small local stdio-to-remote bridge for the [Moose Tracker](https://moosetracker.app/) MCP server. It proxies JSON-RPC from a local MCP client to `https://mcp.moosetracker.app/mcp`. It contains no engine code and no secrets.
+
+This package is MIT-licensed. Moose Tracker itself is a separate product.
+
+## Setup
+
+Requires Node.js 18 or later. No sign-in and no API key.
+
+The connector URL is `https://mcp.moosetracker.app/mcp` (Streamable HTTP). This bridge is for clients that speak MCP over stdio.
+
+```json
+{
+  "mcpServers": {
+    "moose-tracker": {
+      "command": "npx",
+      "args": ["-y", "moosetracker-mcp"]
+    }
+  }
+}
+```
+
+You can also run it directly:
+
+```
+npx moosetracker-mcp
+```
+
+Optional: set `MOOSETRACKER_MCP_URL` to a different MCP URL (for tests or a staging host). The default is the live server above.
+
+A share link from the `song` tool plays the song in the browser and does not need a render. Use `render` or `sfx` when you want audio files to embed in a game, an app, a presentation or a video.
+
+More setup, including adding the remote URL directly in clients that support Streamable HTTP, is at https://moosetracker.app/ai.
+
+## License
+
+MIT. See `LICENSE`.

package/bin/moosetracker-mcp.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+// © 2026 Kurtis Alexander. MIT License.
+// Tiny stdio-to-remote MCP bridge. No engine code, no secrets. Forwards JSON-RPC
+// between a local MCP client (Content-Length stdio) and the live Streamable HTTP server.
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { stdin, stdout, stderr } from "node:process";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(here, "../package.json"), "utf8"));
+const DEFAULT_URL = "https://mcp.moosetracker.app/mcp";
+
+function argUrl() {
+  const i = process.argv.indexOf("--url");
+  if (i >= 0 && process.argv[i + 1]) return process.argv[i + 1];
+  return process.env.MOOSETRACKER_MCP_URL || DEFAULT_URL;
+}
+
+const url = argUrl();
+let sessionId = null;
+
+function writeMessage(obj) {
+  const json = JSON.stringify(obj);
+  const body = Buffer.from(json, "utf8");
+  stdout.write(`Content-Length: ${body.length}\r\n\r\n`);
+  stdout.write(body);
+}
+
+function parseSseOrJson(text, contentType) {
+  if (contentType && contentType.includes("text/event-stream")) {
+    const payloads = [];
+    for (const block of text.split(/\n\n/)) {
+      const data = block.split("\n").filter(l => l.startsWith("data:")).map(l => l.slice(5).trimStart()).join("\n");
+      if (data) {
+        try { payloads.push(JSON.parse(data)); } catch { /* ignore keepalives */ }
+      }
+    }
+    return payloads;
+  }
+  return [JSON.parse(text)];
+}
+
+async function forward(msg) {
+  const headers = {
+    "content-type": "application/json",
+    "accept": "application/json, text/event-stream",
+    "user-agent": `moosetracker-mcp/${pkg.version}`,
+  };
+  if (sessionId) headers["mcp-session-id"] = sessionId;
+  const res = await fetch(url, { method: "POST", headers, body: JSON.stringify(msg) });
+  const sid = res.headers.get("mcp-session-id");
+  if (sid) sessionId = sid;
+  const text = await res.text();
+  if (res.status === 204 || text.trim() === "") {
+    if (msg.id === undefined) return []; // notification
+    return [{ jsonrpc: "2.0", id: msg.id, error: { code: -32000, message: `empty reply from ${url} (HTTP ${res.status})` } }];
+  }
+  try {
+    return parseSseOrJson(text, res.headers.get("content-type") || "");
+  } catch (e) {
+    if (msg.id === undefined) return [];
+    return [{ jsonrpc: "2.0", id: msg.id, error: { code: -32000, message: `bad reply from ${url} (HTTP ${res.status}): ${String(e.message || e).slice(0, 200)}` } }];
+  }
+}
+
+async function onMessage(msg) {
+  try {
+    const replies = await forward(msg);
+    for (const r of replies) writeMessage(r);
+  } catch (e) {
+    if (msg && msg.id !== undefined) {
+      writeMessage({ jsonrpc: "2.0", id: msg.id, error: { code: -32000, message: String(e.message || e).slice(0, 300) } });
+    } else {
+      stderr.write(`moosetracker-mcp: ${String(e.message || e)}\n`);
+    }
+  }
+}
+
+let buf = Buffer.alloc(0);
+stdin.on("data", chunk => {
+  buf = Buffer.concat([buf, chunk]);
+  for (;;) {
+    const headerEnd = buf.indexOf("\r\n\r\n") >= 0 ? buf.indexOf("\r\n\r\n") : buf.indexOf("\n\n");
+    const sepLen = buf.indexOf("\r\n\r\n") >= 0 ? 4 : (buf.indexOf("\n\n") >= 0 ? 2 : 0);
+    if (headerEnd < 0) break;
+    const header = buf.subarray(0, headerEnd).toString("utf8");
+    const m = /content-length:\s*(\d+)/i.exec(header);
+    if (!m) { buf = buf.subarray(headerEnd + sepLen); continue; }
+    const len = Number(m[1]);
+    const start = headerEnd + sepLen;
+    if (buf.length < start + len) break;
+    const json = buf.subarray(start, start + len).toString("utf8");
+    buf = buf.subarray(start + len);
+    let msg;
+    try { msg = JSON.parse(json); } catch (e) {
+      writeMessage({ jsonrpc: "2.0", id: null, error: { code: -32700, message: "parse error" } });
+      continue;
+    }
+    onMessage(msg);
+  }
+});
+stdin.on("end", () => process.exit(0));
+stdin.resume();

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "moosetracker-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.2.9",
+  "description": "A retro synthesizer and music tracker MCP server: your assistant writes sound effects and songs as notes, and Moose Tracker plays them. Share links play in the browser; render and sfx produce files to embed.",
+  "license": "MIT",
+  "author": {
+    "name": "Kurtis Alexander",
+    "email": "moose@moosetracker.app"
+  },
+  "homepage": "https://moosetracker.app/ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moose-tracker/moose-tracker-plugin.git"
+  },
+  "bugs": {
+    "url": "https://moosetracker.app/about.html"
+  },
+  "type": "module",
+  "bin": {
+    "moosetracker-mcp": "bin/moosetracker-mcp.js"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.js",
+    "pack:check": "npm pack --dry-run"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "moose-tracker",
+    "music",
+    "stdio"
+  ],
+  "dependencies": {}
+}