@audiolabtools/mcp-server 0.4.3 → 0.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.md +15 -8
- package/error-docs.mjs +2 -2
- package/hosted-server.mjs +11 -6
- package/package.json +1 -1
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 Nathan Renting
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Nathan Renting
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
# @audiolabtools/mcp-server
|
|
2
2
|
|
|
3
|
+
[](https://mcpservers.org/servers/audio-launch/audiolab-mcp-server)
|
|
4
|
+
|
|
3
5
|
MCP ([Model Context Protocol](https://modelcontextprotocol.io)) server that gives any
|
|
4
6
|
MCP-capable AI (Claude Desktop, Claude Code, Cursor, and others) ten audio-analysis
|
|
5
7
|
tools, backed by the hosted **AudioLab** API. It is a thin HTTP client: **no local audio
|
|
6
|
-
engine, no ffmpeg, nothing to compile.** It can
|
|
7
|
-
on your machine
|
|
8
|
+
engine, no ffmpeg, nothing to compile.** It can measure a **public URL** or a **local file**
|
|
9
|
+
on your machine, but the measuring always happens on the hosted API: the file is read here
|
|
10
|
+
and uploaded there (see [Privacy](#privacy)).
|
|
8
11
|
|
|
9
12
|
## Install
|
|
10
13
|
|
|
@@ -48,7 +51,7 @@ Every tool takes **one audio source**: a public `url` **or** a local `path`:
|
|
|
48
51
|
| `analyze_voice` | Voice QA: speech/silence ratio, speaking rate, SNR, noise floor, pause energy, sibilance & clipping risk |
|
|
49
52
|
| `get_speech_segments` | Voiced regions with start/end + per-segment RMS (auto-trim, chapters) |
|
|
50
53
|
| `index_signal` | Content-type guess, tags, clipping/silence regions, brightness & dynamics buckets |
|
|
51
|
-
| `analyze_profile` | One named question, `voice`, `master`, `provenance`, `dataset`, `environment`, `broadcast` or `
|
|
54
|
+
| `analyze_profile` | One named question, `voice`, `master`, `provenance`, `dataset`, `environment`, `broadcast`, `loop`, `room` (reverberation from a clap, a pop, an impulse response or a sweep; pass `roomSource`), `chain` (lost packets) or `pitch` (where a voice sits and how clean it is), answered with only the lenses it needs. These ten need a paid plan; the free tier gets the `basic` profile, keyed by stable lens id. Add `series:true` for the curves, per-block lanes and per-phrase values. Carries a `note` when the profile’s voice lenses land on non-speech material. Full catalogue: <https://audiolab.tools/lenses> |
|
|
52
55
|
| `compare_loudness` | A/B on two sources (`urlA`/`pathA` + `urlB`/`pathB`), returns both results |
|
|
53
56
|
| `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 |
|
|
54
57
|
|
|
@@ -71,11 +74,15 @@ Example asks to your AI:
|
|
|
71
74
|
## Privacy
|
|
72
75
|
|
|
73
76
|
Analysis happens on the AudioLab API, so the audio **does reach `audiolab.tools`**: a `url`
|
|
74
|
-
is fetched server-side, and a local `path` is
|
|
75
|
-
files via a private one-shot signed upload
|
|
76
|
-
returns **numbers only** and does not
|
|
77
|
-
|
|
78
|
-
|
|
77
|
+
is fetched server-side, and a local `path` is read here and uploaded to the API (small
|
|
78
|
+
files in the request body; larger files via a private one-shot signed upload into EU
|
|
79
|
+
storage). The API returns **numbers only** and does not keep your audio: a direct request
|
|
80
|
+
is decoded and discarded inside the request, and a signed upload is swept from storage
|
|
81
|
+
within the hour (see https://audiolab.tools/privacy). This package has no telemetry and
|
|
82
|
+
writes nothing to disk. There is no offline mode, and the engine is not published as an
|
|
83
|
+
installable package. If audio must never leave the machine, don't use a hosted analyser;
|
|
84
|
+
the in-browser labs on the website measure on-device, but they are for people, not for
|
|
85
|
+
agents.
|
|
79
86
|
|
|
80
87
|
## Limits
|
|
81
88
|
|
package/error-docs.mjs
CHANGED
|
@@ -6,9 +6,9 @@
|
|
|
6
6
|
export const DOCS_ERRORS_URL = 'https://audiolab.tools/docs/errors';
|
|
7
7
|
|
|
8
8
|
export const KNOWN_CODES = [
|
|
9
|
-
'invalid_api_key', 'rate_limited', 'quota_exceeded', 'data_quota_exceeded', 'profile_requires_paid_plan', 'file_too_large', 'track_too_long', 'unsupported_format',
|
|
9
|
+
'invalid_api_key', 'rate_limited', 'quota_exceeded', 'data_quota_exceeded', 'profile_requires_paid_plan', 'file_too_large', 'track_too_long', 'unsupported_format', 'room_not_measurable',
|
|
10
10
|
'url_not_allowed', 'url_fetch_failed', 'invalid_json', 'missing_input', 'invalid_parameter', 'batch_too_large', 'upload_not_found', 'unknown_endpoint', 'method_not_allowed',
|
|
11
|
-
'storage_unavailable', 'analysis_error', 'missing_api_key', 'api_timeout', 'api_unreachable', 'invalid_input',
|
|
11
|
+
'storage_unavailable', 'analysis_error', 'missing_api_key', 'api_timeout', 'api_unreachable', 'voice_minutes_exhausted', 'service_paused', 'invalid_input',
|
|
12
12
|
];
|
|
13
13
|
|
|
14
14
|
export const docsUrl = (code) => `${DOCS_ERRORS_URL}#${KNOWN_CODES.includes(code) ? code : 'analysis_error'}`;
|
package/hosted-server.mjs
CHANGED
|
@@ -214,7 +214,7 @@ const wrap = (fn) => async (input) => {
|
|
|
214
214
|
const sourceShape = (local) => local
|
|
215
215
|
? {
|
|
216
216
|
url: z.string().url().optional().describe('Public https URL to the audio file. Provide exactly one of url or path.'),
|
|
217
|
-
path: z.string().optional().describe('Path to a LOCAL audio file on this machine,
|
|
217
|
+
path: z.string().optional().describe('Path to a LOCAL audio file on this machine. It is read here and uploaded to the AudioLab API for measuring, so you do not need to host it publicly (files up to 4 MB go in the request body; larger ones, up to 150 MB, upload over a signed URL and are swept from storage within the hour). Provide exactly one of url or path.'),
|
|
218
218
|
}
|
|
219
219
|
: { url: z.string().url().describe('Public https URL to the audio file.') };
|
|
220
220
|
|
|
@@ -280,20 +280,25 @@ export function buildServer({ apiKey, local = false } = {}) {
|
|
|
280
280
|
+ 'dataset (which of these files are good enough, and why not the rest), '
|
|
281
281
|
+ 'environment (what is in this space, and what kind of noise is it), '
|
|
282
282
|
+ 'broadcast (does this file meet the delivery spec), '
|
|
283
|
-
+ 'loop (is this loop clean, on the grid, and safe to drop in a DAW)
|
|
284
|
-
+ '
|
|
283
|
+
+ 'loop (is this loop clean, on the grid, and safe to drop in a DAW), '
|
|
284
|
+
+ 'room (how long does this room ring per octave band, and is there a flutter echo; needs a recording of one clap, a balloon pop, an impulse response or a sweep), '
|
|
285
|
+
+ 'chain (did this recording lose packets on its way: gaps of digital silence), '
|
|
286
|
+
+ 'pitch (where does this voice sit, how much does it move, how clean is it). '
|
|
287
|
+
+ 'basic is the free tier; the other ten need a paid plan. '
|
|
285
288
|
+ 'Results are keyed by stable lens id. Only the analysis passes the profile needs are run. '
|
|
286
289
|
+ 'Set series:true to also get the curves, the per-block lanes and the per-phrase values,'
|
|
287
290
|
+ 'a much larger payload, so leave it off unless you are going to read them.'
|
|
288
291
|
+ srcDoc,
|
|
289
292
|
inputSchema: {
|
|
290
293
|
...src,
|
|
291
|
-
profile: z.enum(['basic', 'voice', 'master', 'provenance', 'dataset', 'environment', 'broadcast', 'loop'])
|
|
294
|
+
profile: z.enum(['basic', 'voice', 'master', 'provenance', 'dataset', 'environment', 'broadcast', 'loop', 'room', 'chain', 'pitch'])
|
|
292
295
|
.describe('Which question to answer.'),
|
|
293
296
|
series: z.boolean().optional()
|
|
294
297
|
.describe('Include time series, per-block lanes and per-phrase arrays. Off by default.'),
|
|
298
|
+
roomSource: z.enum(['clap', 'balloon', 'impulse', 'sweep']).optional()
|
|
299
|
+
.describe('For the room profile: how the recording was made. clap (default): one clap; balloon: one pop; impulse: the file is an impulse response; sweep: the file holds the sweep of the engine as the room returned it.'),
|
|
295
300
|
},
|
|
296
|
-
}, wrap((i) => analyzeSource('analyze/profile', i, { profile: i.profile, series: i.series === true }, apiKey, local)));
|
|
301
|
+
}, wrap((i) => analyzeSource('analyze/profile', i, { profile: i.profile, series: i.series === true, ...(i.roomSource ? { roomSource: i.roomSource } : {}) }, apiKey, local)));
|
|
297
302
|
|
|
298
303
|
// compare_loudness: two independent sources, each a url or (local only) a path.
|
|
299
304
|
const cmp = local
|
|
@@ -323,7 +328,7 @@ export function buildServer({ apiKey, local = false } = {}) {
|
|
|
323
328
|
const batchSrc = local
|
|
324
329
|
? {
|
|
325
330
|
urls: z.array(z.string().url()).optional().describe('Public https URLs to audio files. Combined max 20 items with paths.'),
|
|
326
|
-
paths: z.array(z.string()).optional().describe('LOCAL audio file paths; each
|
|
331
|
+
paths: z.array(z.string()).optional().describe('LOCAL audio file paths; each is read here and uploaded over a one-shot signed URL, measured by the API, and swept from storage within the hour. Combined max 20 items with urls.'),
|
|
327
332
|
}
|
|
328
333
|
: { urls: z.array(z.string().url()).min(1).max(20).describe('Public https URLs to audio files (max 20).') };
|
|
329
334
|
tool('analyze_batch', {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@audiolabtools/mcp-server",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.5",
|
|
4
4
|
"mcpName": "tools.audiolab/audiolab",
|
|
5
5
|
"description": "MCP server for AudioLab, 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.",
|
|
6
6
|
"type": "module",
|