talkback-mcp 0.1.0 → 0.1.2
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 +27 -0
- package/README.md +77 -0
- package/package.json +2 -2
package/LICENSE
ADDED
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
PolyForm Shield License 1.0.0
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Jacob Medure
|
|
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 use,
|
|
7
|
+
copy, modify, and distribute the Software, subject to the following conditions:
|
|
8
|
+
|
|
9
|
+
1. You may not use the Software to provide a product or service that competes
|
|
10
|
+
with the Software or any product or service offered by the Licensor that
|
|
11
|
+
includes the Software.
|
|
12
|
+
|
|
13
|
+
2. You may not remove or obscure any licensing, copyright, or other notices
|
|
14
|
+
included in the Software.
|
|
15
|
+
|
|
16
|
+
3. If you distribute the Software or any derivative works, you must include a
|
|
17
|
+
copy of this license.
|
|
18
|
+
|
|
19
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
20
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
21
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
22
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
23
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
24
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
25
|
+
SOFTWARE.
|
|
26
|
+
|
|
27
|
+
For more information, see https://polyformproject.org/licenses/shield/1.0.0
|
package/README.md
ADDED
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# Talkback MCP
|
|
2
|
+
|
|
3
|
+
An MCP server that gives AI assistants real-time access to Ableton Live sessions. Read track data, analyze mixes, adjust parameters, and get spectral snapshots — all through natural conversation.
|
|
4
|
+
|
|
5
|
+
## How it works
|
|
6
|
+
|
|
7
|
+
Talkback has two parts:
|
|
8
|
+
|
|
9
|
+
1. **Talkback MCP** (this package) — an MCP server that exposes Ableton session data and controls as tools
|
|
10
|
+
2. **[Talkback Bridge](https://github.com/jmedure/talkback-mcp-bridge)** — a Max for Live device that reads Ableton's Live Object Model and streams it to the MCP server over WebSocket
|
|
11
|
+
|
|
12
|
+
```
|
|
13
|
+
Ableton Live ↔ M4L Bridge ↔ WebSocket ↔ MCP Server ↔ Claude / Cursor / etc.
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
## Quick start
|
|
17
|
+
|
|
18
|
+
### 1. Install the MCP server
|
|
19
|
+
|
|
20
|
+
Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
|
|
21
|
+
|
|
22
|
+
```json
|
|
23
|
+
{
|
|
24
|
+
"mcpServers": {
|
|
25
|
+
"talkback-mcp": {
|
|
26
|
+
"command": "npx",
|
|
27
|
+
"args": ["talkback-mcp"],
|
|
28
|
+
"env": { "WS_PORT": "8765" }
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Or for Claude Code:
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
claude mcp add talkback-mcp -- npx talkback-mcp
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
### 2. Install the bridge
|
|
41
|
+
|
|
42
|
+
Download the latest `.amxd` from [talkback-mcp-bridge releases](https://github.com/jmedure/talkback-mcp-bridge/releases) and drop it onto any track in your Ableton session. The bridge connects automatically.
|
|
43
|
+
|
|
44
|
+
### 3. Start mixing
|
|
45
|
+
|
|
46
|
+
Ask Claude about your session. The tools handle the rest.
|
|
47
|
+
|
|
48
|
+
## Tools
|
|
49
|
+
|
|
50
|
+
| Tool | Description |
|
|
51
|
+
|------|-------------|
|
|
52
|
+
| `get_session_context` | Full session snapshot — tracks, volumes, panning, sends, devices, routing |
|
|
53
|
+
| `get_track_details` | Deep dive into a specific track's device chain and parameters |
|
|
54
|
+
| `get_spectral_snapshot` | ~2 second spectral capture from the master bus (requires playback) |
|
|
55
|
+
| `get_plugin_library` | Lists all installed AU/VST3 plugins on the system |
|
|
56
|
+
| `analyze_mix` | Rule-based heuristic analysis for common mix issues |
|
|
57
|
+
| `set_device_parameter` | Adjust a device parameter (requires user consent) |
|
|
58
|
+
| `toggle_device_bypass` | Enable or bypass a device for A/B comparison |
|
|
59
|
+
| `create_group_track` | Group tracks together |
|
|
60
|
+
| `set_track_routing` | Change a track's output routing |
|
|
61
|
+
| `get_bridge_health` | Performance metrics from the M4L bridge |
|
|
62
|
+
|
|
63
|
+
## Requirements
|
|
64
|
+
|
|
65
|
+
- Ableton Live 11+ with Max for Live
|
|
66
|
+
- Node.js 18+
|
|
67
|
+
- An MCP client (Claude Desktop, Claude Code, Cursor, etc.)
|
|
68
|
+
|
|
69
|
+
## Environment variables
|
|
70
|
+
|
|
71
|
+
| Variable | Default | Description |
|
|
72
|
+
|----------|---------|-------------|
|
|
73
|
+
| `WS_PORT` | `8765` | WebSocket port for bridge connection |
|
|
74
|
+
|
|
75
|
+
## License
|
|
76
|
+
|
|
77
|
+
[PolyForm Shield 1.0.0](LICENSE) — free to use, modify, and distribute. You may not use this software to build a competing product.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "talkback-mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "MCP server giving AI assistants real-time access to Ableton Live sessions",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -33,7 +33,7 @@
|
|
|
33
33
|
"claude",
|
|
34
34
|
"model-context-protocol"
|
|
35
35
|
],
|
|
36
|
-
"license": "
|
|
36
|
+
"license": "PolyForm-Shield-1.0.0",
|
|
37
37
|
"dependencies": {
|
|
38
38
|
"@modelcontextprotocol/sdk": "^1.12.1",
|
|
39
39
|
"dotenv": "^16.4.7",
|