talkback

Name: talkback
Author: jmedure

本地服务

github.com/jmedure媒体与设计2531 周前更新

代码仓库

关于 talkback

talkback 是一个 MCP 服务与 Max for Live 设备的组合，让 AI 助手通过对话实时读取 Ableton Live 会话、调整参数并分析混音。它面向需要在编曲与混音中借助 AI 的音乐制作人，需要在本地桌面客户端中运行。

主要功能

01读取会话中的轨道、音量、声像与路由信息
02以人类可读单位调整设备参数
03采集主总线频谱快照与峰值 RMS 数据
04启发式混音检查，涵盖频率堆积与动态问题
05启用或旁通设备以便 A/B 对比

适用场景

01询问贝斯浑浊或人声发闷等混音问题的原因
02在修改参数前由 AI 助手请求确认并保留撤销能力
03通过对话创建编组轨道或调整输出路由

MCP 相关

该项目是一个 MCP 服务，向桌面 MCP 客户端暴露会话读取、参数设置、混音分析等工具，并通过 WebSocket 连接 Ableton 中的 Max for Live 桥接设备。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "jmedure-talkback": {
      "command": "npx",
      "args": [
        "-y",
        "talkback-mcp"
      ],
      "env": {
        "WS_PORT": "<WS_PORT>"
      }
    }
  }
}

启动命令npx -y talkback-mcp

需要配置的环境变量

WS_PORTWebSocket port for the Max for Live bridge connection

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmtalkback-mcp0.1.3stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

talkback mcp

用自然语言与你的 Ableton 工程对话。深入打磨你的混音，让它听起来和你想的一样，并终于搞懂压缩……开玩笑的，没人能教会你这个。

Talkback 是一个 MCP 服务和 Max for Live 设备，让 AI 助手实时访问你的 Ableton Live 工程 —— 读取轨道、调整参数、分析混音，以及获取频谱快照，全部通过对话完成。

talkback.createwcare.com · 文档 · 更新日志

工作原理

Ableton Live ↔ M4L Bridge ↔ WebSocket ↔ MCP Server ↔ Claude / Cursor / etc.

talkback bridge —— 一个位于主轨道上的 Max for Live 设备，它读取 Live Object Model 并通过 WebSocket 传输工程数据
talkback-mcp（本软件包）—— 一个 MCP 服务，将你的工程暴露为任何大模型都能使用的工具

快速开始

最快速的设置方式 —— 自动安装 MCP 服务并配置 Claude Desktop：

curl -fsSL https://talkback.createwcare.com/install.sh | bash

已经身处 AI Agent 中？让它帮你完成设置：

npx skills add jmedure/talkback-mcp

然后对你的 Agent 说：“帮我设置 talkback”

需要 Node.js 18+。更多选项请参阅完整设置指南。

1. 安装 Max for Live 设备

下载 talkback-bridge（最新版）并把它拖到 Ableton 的主轨道上。确保该设备已打开。

2. 添加 MCP 服务

Talkback 需要桌面 MCP 客户端 —— 它在你的机器上本地运行，并通过 WebSocket 连接到 Ableton。它无法用于浏览器中的 claude.ai（网页聊天尚不支持本地 MCP 服务）。

Claude Desktop（推荐）

下载 Claude Desktop，然后添加到你的配置中：

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "talkback-mcp": {
      "command": "npx",
      "args": ["-y", "talkback-mcp"],
      "env": { "WS_PORT": "8765" }
    }
  }
}

保存后重启 Claude Desktop。

使用 nvm 或 fnm？ Claude Desktop 不会加载你的 shell 配置文件，因此它可能会使用旧的系统 Node。请改用 npx 的完整路径 —— 在终端中运行 which npx，然后将其设置为上面配置中的 "command"。详情请参阅故障排查。

Claude Code

claude mcp add --transport stdio talkback-mcp -- npx -y talkback-mcp

Cursor

添加到项目根目录下的 .cursor/mcp.json：

{
  "mcpServers": {
    "talkback-mcp": {
      "command": "npx",
      "args": ["-y", "talkback-mcp"],
      "env": { "WS_PORT": "8765" }
    }
  }
}

其他客户端（Windsurf 等）

将你的客户端指向 npx -y talkback-mcp 作为服务命令，并以 WS_PORT=8765 作为环境变量。

或者使用 add-mcp 自动配置你已安装的所有 Agent：

npx add-mcp "npx -y talkback-mcp"

3. 开始对话

打开你的大模型，开始询问你的工程：

“我的工程里现在是什么情况？”
“我的贝斯听起来很浑浊，能帮我吗？”
“在人声 EQ 上把 300 Hz 衰减 3 dB”
“我的混音有明显的問題吗？”

你的大模型在进行任何参数更改前都会请求批准。撤销始终有效。

工具

工具	功能
`get_session_context`	读取你的完整会话——轨道、音量、声像、静音、发送、设备、路由
`get_track_details`	深入查看单个轨道，以人类可读的单位显示每个设备参数
`get_spectral_snapshot`	从主总线捕获约 2 秒的实时音频，并给出每个频段的峰值/RMS
`get_plugin_library`	列出你系统上已安装的所有 AU 和 VST3 插件
`analyze_mix`	对频率堆积、动态、余量和路由问题进行启发式检查
`set_device_parameter`	使用人类可读的单位（dB、ms、Hz 等）更改设备参数
`toggle_device_bypass`	启用或旁通设备以进行 A/B 对比
`create_group_track`	创建一个包含指定轨道的新编组轨道
`set_track_routing`	将轨道的输出路由更改为另一条轨道或总线
`get_bridge_health`	返回来自 M4L 设备的桥接性能指标

要求

Ableton Live 11+，带 Max for Live
Node.js 18+
桌面 MCP 客户端——Claude Desktop（推荐）、Claude Code、Cursor 或类似工具

环境变量

变量	默认值	描述
`WS_PORT`	`8765`	用于桥接连接的 WebSocket 端口

许可证

PolyForm Shield 1.0.0——可自由使用、修改和分发。你不得使用本软件构建竞争产品。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。