tsuru0805/speak-aloud-mcp

MCP server: 让你的Ai用电脑发出声音(ElevenLabs TTS, volume set/restore). macOS / Windows / Linux.

About speak-aloud-mcp

一个很小的 MCP server，给任何 MCP 客户端（Claude Desktop / Claude Code / claude.ai Connectors / 你自己的 agent）加两个工具——核心不依赖 MCP，从自己的网关直连 API 的人当普通 Python 库用就行，见下文：

工具 做什么 ------ speak(text, voice) ElevenLabs 合成 → 存成音频文件 → 返回路径。不出声。 speakaloud(text, voice) 同上，然后当场从本机音响播出来：静音的话先解开 → 把系统音量设到你指定的值 → 播 → 播完先把原音量放回去、再把静音状态放回去，两样都读回来核一遍。

macOS / Windows / Linux 都能跑，播放不装任何第三方 Python 音频库（macOS/Windows 用系统自带的播放器；Linux 要有 paplay/aplay，一般装了 PulseAudio/PipeWire 就有）。

我们的家用系统 tilldusk 里有几个长期在线的 AI agent，跑在一台 24/7 的 Mac mini 上。它们会被定时/事件唤醒，醒了有话想说——之前只能"发一条语音消息等人点开"。这个 server 让"说"就是说：它自己醒了、想道早安，声音就从屋里的音响出来，不用任何人去点播放。

顺手解决的两件小事： - 音量：夜里/白天系统音量不定，播之前设成固定值，播完复原，别把音量留在奇怪的位置。 - 回执要诚实：播没播出来、音量有没有复原，结果里明说；不许"合成成功了就当播了"。

（PyPI 包名 speak-aloud-mcp 尚未发布；发了会把这里换成 pip install speak-aloud-mcp。）需要 Python ≥ 3.10、mcp SDK 1.19–1.x。

变量 必填 说明 --------- ELEVENLABSAPIKEY ✅ ElevenLabs API key，必须 sk 开头。后台里那串不带 sk 的是 key ID，不是 key——用错了 ElevenLabs 会回 “API key ID used as API key”。 SPEAKALOUDVOICES ✅（二选一） 名字=voiceid,名字2=voiceid2，第一个是默认声。 ELEVENLABSVOICEID ✅（二选一） 只有一个声的时候用这个，名字自动叫 default。 SPEAKALOUDVOLUME 播放时的系统音量 0-100，默认 35。设成 off = 不碰音量。 SPEAKALOUDFORMAT wav（默认：macOS/Windows 系统自带播放器直接播，Linux 用 paplay/aplay）或 mp3（macOS afplay；Linux mpg123/ffplay；Windows 需要 ffplay）。 SPEAKALOUDALLOWEDHOSTS 只在 --transport http 有用：逗号分隔的公网主机名（隧道给你的那个）。localhost 和 --host 绑的局域网 IP 一直放行，其余 421。见下文。 SPEAKALOUDCACHEDIR 音频文件落哪。默认系统缓存目录下 speak-aloud-mcp/。 SPEAKALOUDMAXCHARS 单次最长字符数，默认 1000。ElevenLabs 按字符计费，这是防手滑。 ELEVENLABSMODELID 默认 elevenmultilingualv2。

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/tsuru0805--speak-aloud-mcp.html)

Related MCP servers