Audio Studio MCP 共享服务器部署:一个HTTP进程让多个MCP客户端共用同一份模型

原创2026-11-13 21:58:071,350 阅读

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 与多个客户端同时接入同一进程。

Audio Studio MCP 项目封面:在本机用 AI 生成 BGM 和音效,供 MCP 客户端使用

为什么需要共享服务器部署

默认情况下(stdio 模式),每个客户端会话都会各自拉起一个独立的服务器进程。这意味着:

  • 每个进程首次生成前都要加载模型(medium 模型冷启动约 10~25 秒);
  • 每个进程加载后各占约 5–7 GB 内存(Mac)或 5 GB+ 显存(NVIDIA GPU);
  • 打开多个 Claude Code 会话、再配上 Claude Desktop,就会出现多份重复的模型副本。

而 --http 模式只启动一个常驻 HTTP 进程,所有客户端会话共享同一份模型和同一个空闲卸载计时,天然适合多客户端并用的场景。

Claude Code 通过 generate_audio 和 process_audio 生成的实际会话截图

两种模式的区别:--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

Audio Studio MCP Web UI 生成页面截图:候选对比、试听与导出

  • 页面和 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 音频工作站",让所有客户端共享它即可。

登录后查看全文
audio-studio-mcp