MCP Voice Soundboard

日本語 | 中文 | Español | Français | हिन्दी | Italiano | Português (BR)

48 voices • 9 languages • 5 presets • 8 emotions • SSML-lite • SFX tags • multi-speaker dialogue

Swappable TTS backends. Guardrails built in. Ships as a single npx command.

______________________________________________________________________

亮点

• MCP本地 --stdio传输，适用于Claude Desktop、Cursor和任何MCP客户端
• 5工具 — voice_speak, voice_dialogue, voice_status, voice_interrupt, voice_inner_monologue
• 48种批准的声音，9种语言 --英语（美国+英国）、日语、普通话、西班牙语、法语、印地语、意大利语、巴西葡萄牙语。精心策划的预设： narrator, announcer, whisper, storyteller, assistant
• 情绪跨度 --8种情绪 {joy}...{/joy} 内联标记
• SSML lite — `

, , ` 没有完整的SSML复杂性

• SFX标签 — [ding], [chime], [whoosh], [tada], [pop], [click] 内联音效
• 多人对话 — Speaker: line 带有自动转换和暂停指令的格式
• 护栏 --速率限制、并发信号量、请求超时、路径遍历保护、秘密编校
• 可更换后端 --Mock（内置）、HTTP代理、Python桥或自带

快速开始

npx @mcptoolshop/voice-soundboard-mcp

或全局安装：

npm install -g @mcptoolshop/voice-soundboard-mcp
voice-soundboard-mcp

克劳德桌面/MCP客户端配置

添加到MCP客户端配置中（例如。 claude_desktop_config.json):

{
  "mcpServers": {
    "voice-soundboard": {
      "command": "npx",
      "args": ["-y", "@mcptoolshop/voice-soundboard-mcp"]
    }
  }
}

有选项：

{
  "mcpServers": {
    "voice-soundboard": {
      "command": "npx",
      "args": [
        "-y", "@mcptoolshop/voice-soundboard-mcp",
        "--artifact=path",
        "--output-dir=/tmp/voice-output",
        "--timeout=30000",
        "--max-concurrent=2"
      ]
    }
  }
}

MCP工具

voice_speak

从文本合成语音。

text:         "Hello world!"
voice?:       "am_fenrir"          # Voice ID or preset name
speed?:       1.0                  # 0.5 - 2.0
mood?:        "dry"                # Humor mood (sensor-humor integration)
format?:      "wav"                # wav | mp3 | ogg | raw
artifactMode?: "path"             # path | base64
outputDir?:   "subdir"            # Subdirectory within output root
sfx?:         true                # Enable [ding], [chime] etc.

voice_dialogue

多人对话合成。

script:       "Alice: Hello!\nBob: Hey there!"
cast?:        { "Alice": "af_sky", "Bob": "am_fenrir" }
speed?:       1.0
concat?:      true                 # Combine into single file
debug?:       true                 # Include cue_sheet
artifactMode?: "path"             # path | base64
outputDir?:   "subdir"            # Subdirectory within output root

voice_status

返回引擎运行状况、可用语音、预设和后端信息。没有争论。

voice_interrupt

停止或回滚活动合成。

streamId?:    "stream-123"
reason?:      "user_spoke"         # user_spoke | context_change | timeout | manual

voice_inner_monologue

用于环境叙事的短暂微话语。需要 --ambient 旗帜或 VOICE_SOUNDBOARD_AMBIENT_ENABLED=1.

text:         "Interesting..."     # Max 500 chars, auto-redacted
category?:    "thinking"           # general | thinking | observation | debug

声音

来自9种语言的48个声音。语言是从语音ID前缀自动推断出来的，不需要配置。

英语-美国

英语-英国

日语

普通话

西班牙语

法语

印地语

意大利语

巴西葡萄牙语

预设

情感跨度

将文本包裹在情感标签中，以控制韵律和语音路由：

{joy}Great news!{/joy} But {calm}let me explain.{/calm}

支持： neutral, serious, friendly, professional, calm, joy, urgent, whisper

CLI标志

包裹

这是一个pnpm monorepo，有两个可发布的包：

发展

# Install
pnpm install

# Build
pnpm build

# Test (363 tests)
pnpm test

# Build + test in one step
pnpm verify

部分 MCP工具车间

项目结构

mcp-voice-soundboard/
  packages/
    core/               @mcptoolshop/voice-soundboard-core
      src/
        limits.ts         SHIP_LIMITS, text/chunk limits
        schemas.ts        VoiceRequest, VoiceResponse, error codes
        artifact.ts       resolveOutputDir, path sandbox
        voices.ts         Approved voice registry + presets
        emotion.ts        Emotion span parser
        ssml/             SSML-lite parser + limits
        chunking/         Text chunker
        sfx/              SFX tag parser + registry
        sandbox.ts        Safe filenames, symlink checks
        ambient.ts        AmbientEmitter for inner monologue
        redact.ts         PII/secret redaction
    mcp-server/         @mcptoolshop/voice-soundboard-mcp
      src/
        server.ts         MCP tool registration + guardrail wiring
        cli.ts            CLI entrypoint (stdio transport)
        backend.ts        Backend abstraction + mock/HTTP
        concurrency.ts    SynthesisSemaphore
        rateLimit.ts      ToolRateLimiter (sliding window)
        timeout.ts        withTimeout utility
        retention.ts      Output file cleanup timer
        redact.ts         Server-level redaction
        validation.ts     Synthesis result validation
        tools/            Individual tool handlers
  assets/               Logo, audio event manifests
  docs/                 Architecture docs

隐私

没有遥测。 此工具不收集使用数据，不发送分析，也不向您配置的TTS后端发出网络请求。所有处理都是本地的。

安全

看 安全.md 用于漏洞报告。

看 线程_模式.md 进行全面的威胁面分析。

相关

支持

• 问题/帮助： 讨论
• Bug报告： 问题
• 安全： 安全.md

记分卡

许可证

麻省理工学院

______________________________________________________________________

Built by MCP Tool Shop