内容
# 语音MCP
统一的语音转文本/文本转语音MCP服务器 — 通过WhisperX实现语音转文本,通过ComfyUI/Qwen3实现文本转语音,可选的HTTP封装。
## 工具列表
| 工具 | 描述 |
|---|---|
| `speech__record` | 从USB麦克风录音(N秒) |
| `speech__transcribe` | 通过WhisperX转录音频文件 |
| `speech__tts` | 通过TTS端点实现文本转语音 |
## 安装配置
```bash
cd speech-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
cp .env.example .env # 调整WHISPERX_URL / TTS_URL / MIC_DEVICE
```
## MCP注册
```json
{
"mcpServers": {
"speech-mcp": {
"command": ".venv/bin/python",
"args": ["server.py"]
}
}
}
```
## HTTP模式(可选)
```bash
.venv/bin/python http_server.py
# 在 http://localhost:8902 提供服务
```
## 配置
所有配置通过环境变量(参见 `.env.example`):
| 变量 | 默认值 | 描述 |
|---|---|---|
| `WHISPERX_URL` | `localhost:48001` | WhisperX服务端点 |
| `TTS_URL` | `localhost:8188` | TTS服务端点 |
| `MIC_DEVICE` | `hw:1,0` | ALSA麦克风设备 |
| `RECORD_DIR` | `/tmp/speech-mcp-recordings` | 录音临时目录 |
## 许可证
MIT — 参见 `LICENSE`。