Audio Studio MCP 共享服务器部署:一个HTTP进程让多个MCP客户端共用同一份模型
Audio Studio MCP 共享服务器部署:一个HTTP进程让多个MCP客户端共用同一份模型
Audio Studio MCP 除了默认的 stdio 模式,还支持 HTTP 共享服务器模式:只需启动一个 audio-studio-mcp 进程,Claude Code、Claude Desktop、Cursor 等多个 MCP 客户端就能通过同一个 HTTP 端口共用同一份已加载的 Stable Audio 3 模型,无需各自加载、无需云服务和 API Key。本文带你 5 分钟完成部署,并让 Web UI 与多个客户端同时接入同一进程。
为什么需要共享服务器部署
默认情况下(stdio 模式),每个客户端会话都会各自拉起一个独立的服务器进程。这意味着:
- 每个进程首次生成前都要加载模型(medium 模型冷启动约 10~25 秒);
- 每个进程加载后各占约 5–7 GB 内存(Mac)或 5 GB+ 显存(NVIDIA GPU);
- 打开多个 Claude Code 会话、再配上 Claude Desktop,就会出现多份重复的模型副本。
而 --http 模式只启动一个常驻 HTTP 进程,所有客户端会话共享同一份模型和同一个空闲卸载计时,天然适合多客户端并用的场景。
两种模式的区别:--http 还是 --web?
| 模式 | 启动命令 | 提供什么 |
|---|---|---|
| 纯 HTTP | audio-studio-mcp --http 8765 |
只有 /mcp 接口,给 MCP 客户端用 |
| Web + HTTP | audio-studio-mcp --web 8765 |
同一端口同时提供:/mcp(MCP 接口)+ /(Web UI 页面)+ /api/*(页面用的 JSON API) |
--web 就是 --http 的超集——同一个端口同时服务三类路由,所以 Web UI 页面和 MCP 客户端共用一个进程、一份模型,双方的请求还会排进同一条 FIFO 队列,按序执行。相关实现见 web.py,启动参数定义在 server.py 的 main() 中。
共享服务器部署步骤
第一步:启动常驻 HTTP 进程
先完成 README 快速开始 中的安装,然后启动共享服务器:
# macOS / Apple Silicon
.venv/bin/audio-studio-mcp --http 8765 --preload
# Windows(NVIDIA GPU)
.venv\Scripts\audio-studio-mcp.exe --http 8765 --preload
两个参数值得注意:
--http PORT:把服务器从 stdio 切换为仅监听 127.0.0.1 的 streamable-HTTP 服务;--preload:启动时预加载模型,让第一个请求免去冷启动等待。共享模式下建议始终加上,这正是"常驻一个热进程"的核心收益。
第二步:把客户端指向这个 HTTP 端口
每个客户端只需用 HTTP 传输注册一次,指向同一个地址即可:
# Claude Code
claude mcp add --scope user --transport http audio-studio http://127.0.0.1:8765/mcp
其他客户端(Claude Desktop、Cursor 等)在各自的 MCP 配置中写一个 mcpServers 条目,地址填 http://127.0.0.1:8765/mcp,具体格式见 README.zh-CN.md 的客户端配置示例。
第三步:验证
打开多个 Claude Code 会话,各自下达一句生成请求(如"做一段 30 秒的 lo-fi BGM,给我 2 个候选")。你会发现只有第一次请求较快,之后的请求来自同一个热模型——没有重复加载、没有内存翻倍。
--web 模式:Web UI 与 MCP 客户端同时接入
用 --web 启动后,浏览器打开 http://127.0.0.1:8765/ 就能使用图形界面:
.venv/bin/audio-studio-mcp --web 8765 --preload
- 页面和 MCP 客户端共享同一个进程、同一份已加载的模型,页面请求与智能体请求排在同一条队列中;
- 加
--no-browser可跳过自动打开浏览器; - 生成的文件统一写入
outputs/目录(可用环境变量AUDIO_STUDIO_OUTPUT_DIR改位置),Web UI 的作品库浏览的就是这个目录。
关键配置:环境变量一览
| 变量 | 默认值 | 作用 |
|---|---|---|
AUDIO_STUDIO_OUTPUT_DIR |
<repo>/outputs |
音频文件输出目录 |
AUDIO_STUDIO_IDLE_UNLOAD_MIN |
10 |
空闲多少分钟后自动卸载模型(0 = 永不卸载,纯共享常驻场景可设为 0) |
AUDIO_STUDIO_SA3_MODEL |
medium |
模型档位:medium 质量最好(最长 380 秒),sm-music / sm-sfx 更小巧更快 |
这些变量可以随启动命令传入,也可以写在客户端 MCP 配置的 env 块里(claude mcp add ... -e NAME=value)。完整变量表见 README.zh-CN.md 的"配置"一节。
部署注意事项
- ⚠️ 只监听
127.0.0.1,仅限本机使用。 不要通过端口转发、反向代理或隧道把它暴露到其他机器:Web UI 没有登录机制,任何能打开页面的人都能占用你的 GPU 并往输出目录写文件。 - 共享进程不会自动退出:空闲超时只卸载模型、进程仍在;想立即释放显存/内存可让客户端调用
unload_models工具,停止服务则 Ctrl+C。 - 生成请求在队列中按序执行,多个客户端同时发任务时界面会显示排队位置,属正常现象。
- 完整工具集(
generate_audio、edit_audio、process_audio、unload_models)与参数说明见 server.py,安装脚本为 install.sh(macOS)与 install.ps1(Windows)。
小结
| 场景 | 推荐方式 |
|---|---|
| 单个客户端、偶尔使用 | 默认 stdio 模式即可,最省心 |
| 多个客户端 / 多个会话长期并用 | --http PORT --preload,一个进程一份模型 |
| 既想点网页、又想接多个 MCP 客户端 | --web PORT --preload,同端口共享模型与队列 |
记住三个要点:一个端口、一个模型、一条队列。配置完成后,把这份常驻进程当作你的"本地 AI 音频工作站",让所有客户端共享它即可。


