@audiolabtools/mcp-server 0.3.0 → 0.3.2

package/README.md

@@ -1,90 +1,91 @@
-# @audiolabtools/mcp-server
-
-MCP ([Model Context Protocol](https://modelcontextprotocol.io)) server that gives any
-MCP-capable AI — Claude Desktop, Claude Code, Cursor, and others — eight audio-analysis
-tools, backed by the hosted **AudioLab** API. It is a thin HTTP client: **no local audio
-engine, no ffmpeg, nothing to compile.** It can analyse a **public URL** or a **local file**
-on your machine.
-
-## Install
-
-Point your MCP client at the package via `npx` (nothing to install globally):
-
-```json
-{
-  "mcpServers": {
-    "audiolab": {
-      "command": "npx",
-      "args": ["-y", "@audiolabtools/mcp-server"],
-      "env": { "AUDIOLAB_API_KEY": "al_live_yourkey" }
-    }
-  }
-}
-```
-
-Get a key: sign in at **https://audiolab.tools/account** and generate one (free tier available).
-
-## Requirements
-
-- **Node ≥ 18** — uses the built-in global `fetch` + `AbortSignal.timeout`.
-- An `AUDIOLAB_API_KEY`. No ffmpeg, no native dependencies.
-
-## Tools
-
-Every tool takes **one audio source** — a public `url` **or** a local `path`:
-
-- `{ url: "https://…" }` — a public https URL the API fetches server-side.
-- `{ path: "./mix.wav" }` — a file on the machine running this server. Files up to **4 MB**
-  are sent inline; larger files (up to **50 MB**) upload over a one-shot signed URL, are
-  analysed, and are then deleted. *(Local `path` works only in this stdio server, not the
-  remote `/mcp` endpoint.)*
-
-| Tool | Returns |
-|---|---|
-| `analyze_loudness` | Integrated LUFS (EBU R128 / BS.1770-4), true-peak (dBTP), LRA, crest factor, stereo correlation, mono compatibility, tonal balance |
-| `check_target` | Pass/fail vs a delivery target (`spotify` / `apple-music` / `youtube` / `tidal` / `amazon-music` / `podcast` / `ebu-broadcast` / `atsc-broadcast`, or `target:"custom"` + `lufs`+`tp`), with per-metric deltas and an ffmpeg loudnorm fix command |
-| `analyze_timeseries` | Short-term LUFS over time + downsampled waveform peaks (`waveformPoints?`) |
-| `get_spectrum` | FFT magnitude data + 7-band energies + dominant band |
-| `analyze_voice` | Voice QA: speech/silence ratio, speaking rate, SNR, noise floor, room echo, sibilance & clipping risk |
-| `get_speech_segments` | Voiced regions with start/end + per-segment RMS (auto-trim, chapters) |
-| `index_signal` | Content-type guess, tags, clipping/silence regions, brightness & dynamics buckets |
-| `compare_loudness` | A/B on two sources (`urlA`/`pathA` + `urlB`/`pathB`), returns both results |
-
-Example asks to your AI:
-
-- *“Analyze the loudness of https://example.com/track.wav”* → `analyze_loudness` with `url`
-- *“Run loudness on ./master.wav”* → `analyze_loudness` with `path`
-- *“Does ./mix.mp3 pass Spotify?”* → `check_target` with `path` + `target:"spotify"`
-
-## Configuration (env)
-
-| Var | Default | Purpose |
-|---|---|---|
-| `AUDIOLAB_API_KEY` | — (required) | Your API key. |
-| `AUDIOLAB_API_BASE` | `https://audiolab.tools/v1` | Override the API base (must be `https://`). |
-| `AUDIOLAB_TIMEOUT_MS` | `60000` | Per-request timeout in milliseconds. |
-
-## Privacy
-
-Analysis happens on the AudioLab API, so the audio **does reach `audiolab.tools`** — a `url`
-is fetched server-side, and a local `path` is sent to the API (small files inline; larger
-files via a private one-shot signed upload that is deleted right after analysis). The API
-returns **numbers only** and does not retain your audio (see https://audiolab.tools/privacy).
-This package has no telemetry and writes nothing to disk. If audio must never leave the
-machine, don't use a hosted analyser.
-
-## Limits
-
-- Local files: up to **50 MB** (host bigger ones at a public URL).
-- One file per call (agents loop for many); one-shot (no streaming/realtime).
-- Rate and monthly limits are enforced by the API, per key.
-
-## Smoke test
-
-```sh
-node hosted-server.mjs --selftest   # verifies the 9 tools + guards; no network
-```
-
-## License
-
-MIT © Nathan Renting
+# @audiolabtools/mcp-server
+
+MCP ([Model Context Protocol](https://modelcontextprotocol.io)) server that gives any
+MCP-capable AI — Claude Desktop, Claude Code, Cursor, and others — nine audio-analysis
+tools, backed by the hosted **AudioLab** API. It is a thin HTTP client: **no local audio
+engine, no ffmpeg, nothing to compile.** It can analyse a **public URL** or a **local file**
+on your machine.
+
+## Install
+
+Point your MCP client at the package via `npx` (nothing to install globally):
+
+```json
+{
+  "mcpServers": {
+    "audiolab": {
+      "command": "npx",
+      "args": ["-y", "@audiolabtools/mcp-server"],
+      "env": { "AUDIOLAB_API_KEY": "al_live_yourkey" }
+    }
+  }
+}
+```
+
+Get a key: sign in at **https://audiolab.tools/account** and generate one (free tier available).
+
+## Requirements
+
+- **Node ≥ 18** — uses the built-in global `fetch` + `AbortSignal.timeout`.
+- An `AUDIOLAB_API_KEY`. No ffmpeg, no native dependencies.
+
+## Tools
+
+Every tool takes **one audio source** — a public `url` **or** a local `path`:
+
+- `{ url: "https://…" }` — a public https URL the API fetches server-side.
+- `{ path: "./mix.wav" }` — a file on the machine running this server. Files up to **4 MB**
+  are sent inline; larger files (up to **50 MB**) upload over a one-shot signed URL, are
+  analysed, and are then deleted. *(Local `path` works only in this stdio server, not the
+  remote `/mcp` endpoint.)*
+
+| Tool | Returns |
+|---|---|
+| `analyze_loudness` | Integrated LUFS (EBU R128 / BS.1770-4), true-peak (dBTP), LRA, crest factor, stereo correlation, mono compatibility, tonal balance |
+| `check_target` | Pass/fail vs a delivery target (`spotify` / `apple-music` / `youtube` / `tidal` / `amazon-music` / `podcast` / `ebu-broadcast` / `atsc-broadcast`, or `target:"custom"` + `lufs`+`tp`), with per-metric deltas and an ffmpeg loudnorm fix command |
+| `analyze_timeseries` | Short-term LUFS over time + downsampled waveform peaks (`waveformPoints?`) |
+| `get_spectrum` | FFT magnitude data + 7-band energies + dominant band |
+| `analyze_voice` | Voice QA: speech/silence ratio, speaking rate, SNR, noise floor, room echo, sibilance & clipping risk |
+| `get_speech_segments` | Voiced regions with start/end + per-segment RMS (auto-trim, chapters) |
+| `index_signal` | Content-type guess, tags, clipping/silence regions, brightness & dynamics buckets |
+| `compare_loudness` | A/B on two sources (`urlA`/`pathA` + `urlB`/`pathB`), returns both results |
+| `analyze_batch` | One route over up to 20 sources in a single call (`urls` and/or `paths`), per-item ok/data/error. For folder QA, library indexing, or checking a whole release against a target. Each item meters as one call |
+
+Example asks to your AI:
+
+- *“Analyze the loudness of https://example.com/track.wav”* → `analyze_loudness` with `url`
+- *“Run loudness on ./master.wav”* → `analyze_loudness` with `path`
+- *“Does ./mix.mp3 pass Spotify?”* → `check_target` with `path` + `target:"spotify"`
+
+## Configuration (env)
+
+| Var | Default | Purpose |
+|---|---|---|
+| `AUDIOLAB_API_KEY` | — (required) | Your API key. |
+| `AUDIOLAB_API_BASE` | `https://audiolab.tools/v1` | Override the API base (must be `https://`). |
+| `AUDIOLAB_TIMEOUT_MS` | `60000` | Per-request timeout in milliseconds. |
+
+## Privacy
+
+Analysis happens on the AudioLab API, so the audio **does reach `audiolab.tools`** — a `url`
+is fetched server-side, and a local `path` is sent to the API (small files inline; larger
+files via a private one-shot signed upload that is deleted right after analysis). The API
+returns **numbers only** and does not retain your audio (see https://audiolab.tools/privacy).
+This package has no telemetry and writes nothing to disk. If audio must never leave the
+machine, don't use a hosted analyser.
+
+## Limits
+
+- Local files: up to **50 MB** (host bigger ones at a public URL).
+- One file per call (agents loop for many); one-shot (no streaming/realtime).
+- Rate and monthly limits are enforced by the API, per key.
+
+## Smoke test
+
+```sh
+node hosted-server.mjs --selftest   # verifies the 9 tools + guards; no network
+```
+
+## License
+
+MIT © Nathan Renting

package/hosted-server.mjs

@@ -29,8 +29,15 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { readFile } from 'node:fs/promises';
 import { basename } from 'node:path';
 import { pathToFileURL } from 'node:url';
+import { createRequire } from 'node:module';
 import { z } from 'zod';
 
+// The version reported over MCP used to be a literal with a "keep in sync with
+// package.json" comment next to it. It drifted anyway: the package shipped 0.3.1
+// while every initialize response still announced 0.3.0. Read it instead, so the
+// comment cannot be ignored and the two cannot disagree.
+const { version: PKG_VERSION } = createRequire(import.meta.url)('./package.json');
+
 // Vercel serverless caps a raw request body at ~4.5 MB, so small files POST directly and
 // larger ones go through the signed-URL storage flow. The bucket policy caps at 50 MB.
 const RAW_MAX = 4 * 1024 * 1024;
@@ -194,7 +201,7 @@ const sourceShape = (local) => local
   : { url: z.string().url().describe('Public https URL to the audio file.') };
 
 export function buildServer({ apiKey, local = false } = {}) {
-  const server = new McpServer({ name: 'audiolab', version: '0.3.0' }); // keep in sync with package.json
+  const server = new McpServer({ name: 'audiolab', version: PKG_VERSION });
   const toolNames = [];
   const tool = (name, def, handler) => { server.registerTool(name, def, handler); toolNames.push(name); };
   const src = sourceShape(local);
@@ -313,7 +320,13 @@ if (isMain && process.argv.includes('--selftest')) {
   await assert.rejects(() => batchSources({ urls: Array.from({ length: 21 }, (_, n) => `https://x/${n}.wav`) }, 'mixlab/analyze', {}, 'al_live_selftest', false), /max 20/, 'oversized batch rejected before network');
   if (prev) process.env.AUDIOLAB_API_KEY = prev; else delete process.env.AUDIOLAB_API_KEY;
 
-  console.log('selftest ok · 9 tools (incl. analyze_batch) + missing-key guard + remote-path refusals + batch guards');
+  // The version announced over MCP drifted from the published package once already
+  // (server said 0.3.0, npm had 0.3.1). Now it is read from package.json, and this
+  // asserts the read actually resolved rather than silently yielding undefined.
+  assert.equal(typeof PKG_VERSION, 'string', 'version resolves from package.json');
+  assert.match(PKG_VERSION, /^\d+\.\d+\.\d+/, 'version looks like a semver');
+
+  console.log(`selftest ok · v${PKG_VERSION} · 9 tools (incl. analyze_batch) + missing-key guard + remote-path refusals + batch guards`);
   process.exit(0);
 }
 

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@audiolabtools/mcp-server",
-  "version": "0.3.0",
+  "version": "0.3.2",
+  "mcpName": "tools.audiolab/audiolab",
   "description": "MCP server for AudioLab \u2014 loudness (EBU R128 / BS.1770-4), true-peak, voice-quality, and signal analysis for AI agents (Claude, Cursor, any MCP client), via the AudioLab hosted API. No local audio engine required.",
   "type": "module",
   "bin": {
@@ -26,7 +27,7 @@
   ],
   "homepage": "https://audiolab.tools/api",
   "bugs": {
-    "url": "https://audiolab.tools/contact"
+    "url": "https://github.com/Audio-Launch/audiolab-mcp-server/issues"
   },
   "license": "MIT",
   "author": "Nathan Renting",
@@ -39,5 +40,9 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.4.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Audio-Launch/audiolab-mcp-server.git"
   }
 }