VoiceStudio（debpalash）— 开源本地 ElevenLabs 替代 · 智能体技能与 MCP

它是什么，不是什么

• 它是在你自己的硬件上运行语音模型的桌面、Docker 和手机软件。应用下载任何模型前都会先询问；已安装的模型可离线运行。
• 它附带智能体技能（skills/voicestudio/SKILL.md）并提供 MCP 接口，Claude Code、Codex、Cursor 等智能体可以通过你的本地后端生成语音和转写。
• 它不是托管的云端 TTS 服务，也无法在本页面直接使用。

技能不等于应用

安装技能只是教会智能体如何与 VoiceStudio 通信。智能体仍然需要一个正在运行的后端，默认地址为 http://localhost:3900。请先启动桌面应用或 Docker 容器，再添加技能或 MCP 连接。

安装

命令抄录自上游 README 和 docs/install/docker.md（提交 4d4cb0badf99，2026 年 10 月 31 日）。我们尚未亲自运行；安装前请先核对 README。

curl -fsSL https://voicestudio.sh/install | sh

irm https://voicestudio.sh/install.ps1 | iex

export OMNIVOICE_API_KEY="$(python3 -c 'import secrets; print(secrets.token_urlsafe(32))')"
docker pull ghcr.io/debpalash/voicestudio:stable

docker run -d --name omnivoice \
  -p 127.0.0.1:3900:3900 \
  -e OMNIVOICE_API_KEY="$OMNIVOICE_API_KEY" \
  -v omnivoice-data:/app/omnivoice_data \
  ghcr.io/debpalash/voicestudio:stable

npx skills add debpalash/VoiceStudio

从 GitHub 最新发布页下载安装包 · 完整 Docker 指南 · 让编程智能体代为安装（docs/install/agent.md）

GPU 还是 CPU？

不需要 GPU。上游说明应用可完全在 CPU 上使用，只是更慢；原生 GGUF 引擎还可以在 AMD、Intel 和 NVIDIA 显卡上使用 Vulkan。我们不引用速度数据，请查看 上游性能页面。

通过 MCP 连接

正在运行的后端会挂载一个 MCP 接口。把任何支持 Streamable HTTP 的客户端指向它，并保留末尾斜杠：

http://localhost:3900/mcp/

桌面应用在 Integrations 中可导出现成配置：Claude Code（.mcp.json）、Cursor（.cursor/mcp.json）和 Codex CLI。docs/mcp.md 中的 Codex CLI 配置如下：

[mcp_servers.voicestudio]
url = "http://127.0.0.1:3900/mcp/"
http_headers = { "X-OmniVoice-Client-Id" = "codex-cli" }

只支持 stdio 的客户端可使用自带的 Python 转接（backend.mcp_shim）。上游提醒 MCP 传输本身没有认证：只在本机或可信局域网使用，切勿暴露到公网。阅读 docs/mcp.md

最小智能体流程

以下步骤来自上游 SKILL.md。我们尚未亲自跑通这个流程。

1. 检查 http://localhost:3900（或你配置的地址）上的 GET /health。
2. 用 GET /openapi.json 获取接口定义，用 GET /v1/audio/voices 获取可用声音。不要编造声音档案 ID。
3. 用 POST /v1/audio/speech 生成语音，或用 POST /v1/audio/transcriptions 转写。
4. 先检查 HTTP 状态并探测保存的文件，再确认它是音频；错误响应也可能被写入输出路径。

授权声音与 AGPL

• 只在声音所有者许可的情况下克隆声音。这是上游的规定，也是本站的要求。
• AGPL-3.0 覆盖应用本身，包括其条款下的商业使用。如果你修改并通过网络提供服务，须履行 AGPL 义务。模型权重、声音和生成内容各有许可，可在 Model Manager 中查看。LICENSE-NOTICE.md
• 收录不等于审计。AgentSkillsDir 没有对这些代码做过安全审查。运行安装脚本前请先阅读。

常见问题

相关

浏览目录中的全部 Claude 技能

更正与建议

发现内容过时，或想推荐一个技能？发送更正邮件。若要推荐资源，请提交供人工审核。