AI导哈

文本转语音插件

为Cursor IDE添加文本转语音功能，使AI助手能够朗读响应、摘要和解释。

  • by EnviralDesign
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 EnviralDesign/mcp-tts

使用说明

用于Cursor IDE的MCP文本转语音

在Cursor IDE中添加文本转语音功能。让你的人工智能助手大声说出回应、总结和解释。

🚀 快速开始

先决条件： 光标IDE 或者a OpenAI API密钥 或a ElevenLabs API密钥

设置： 将其中一个添加到光标MCP设置中(~/.cursor/mcp.json):

{
  "mcpServers": {
    "mcp_tts_server": {
      "command": "uvx",
      "args": ["--from", "mcp-tts", "mcp-tts-server-stdio"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here",
        "ELEVENLABS_API_KEY": "your-elevenlabs-api-key-here",
        "MCP_TTS_PROVIDER": "openai",
        "MCP_TTS_VOICE": "ballad",
        "MCP_TTS_VOICE_PRESET": "default",
        "MCP_TTS_CUSTOM_INSTRUCTIONS": "",
        "MCP_TTS_SPEED": "1.0",
        "MCP_TTS_VOLUME": "0.8",
        "MCP_TTS_DEVICE_NAME": "",
        "MCP_TTS_DEVICE_INDEX": "",
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

OpenAI（语音/预设/速度应用）：

{
  "mcpServers": {
    "mcp_tts_server": {
      "command": "uvx",
      "args": ["--from", "mcp-tts", "mcp-tts-server-stdio"],
      "env": {
        "MCP_TTS_PROVIDER": "openai",
        "OPENAI_API_KEY": "sk-...",
        "MCP_TTS_VOICE": "alloy",
        "MCP_TTS_VOICE_PRESET": "professional",
        "MCP_TTS_CUSTOM_INSTRUCTIONS": "",
        "MCP_TTS_SPEED": "1.0",
        "MCP_TTS_VOLUME": "0.9",
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

ElevenLabs（使用voice_id或确切名称；预设/速度被忽略）：

{
  "mcpServers": {
    "mcp_tts_server": {
      "command": "uvx",
      "args": ["--from", "mcp-tts", "mcp-tts-server-stdio"],
      "env": {
        "MCP_TTS_PROVIDER": "elevenlabs",
        "ELEVENLABS_API_KEY": "eleven-...",
        "MCP_TTS_VOICE": "Adam",
        "MCP_TTS_VOLUME": "0.8",
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

就是这样！ 重新启动Cursor并尝试询问： “你能用文本转语音的方式给我读一份总结吗？”

⚙️ 配置选项

您可以在MCP配置中使用这些环境变量来控制TTS系统：

变量 描述 示例值 默认值
OPENAI_API_KEY 您的OpenAI API密钥（如果使用OpenAI，则需要） sk-proj-abc123... -
ELEVENLABS_API_KEY 您的ElevenLabs API密钥（如果使用ElevenLabs，则需要） eleven-xxx... -
MCP_TTS_PROVIDER 要使用的TTS提供商 openai, elevenlabs openai
MCP_TTS_VOICE 语音选择 OpenAI： alloy, echo, ...•ElevenLabs： voice_id 或确切名称（不区分大小写） ballad
MCP_TTS_VOICE_PRESET 语音风格预设 default, professional, calm, nyc_cabbie, chill_surfer, cheerleader, emo_teenager, eternal_optimist, dramatic default
MCP_TTS_CUSTOM_INSTRUCTIONS 自定义语音指令（覆盖预设） "Speak like a pirate" -
MCP_TTS_SPEED 语音速度 OpenAI： 0.25 向 4.0 •ElevenLabs：忽略 1.0
MCP_TTS_VOLUME 播放音量 0.0 向 1.0 0.8
MCP_TTS_DEVICE_NAME 音频设备名称（部分匹配） "Speakers", "Headphones" -
MCP_TTS_DEVICE_INDEX 音频设备索引 0, 1, 2等等。 -

提示：

  • 打开本地配置页面，从您的帐户中选择ElevenLabs语音（带预览），或调用其API并粘贴 voice_id.
  • OpenAI接受内置的语音名称和预设；ElevenLabs使用 voice_id 或准确的语音名称。ElevenLabs忽略预设/指令/速度。

语音预设

您可以使用这些内置的语音风格预设：

  • default -清晰、友好、健谈
  • professional -权威的商业声音
  • calm -镇定自若，用平静的权威让人安心
  • nyc_cabbie -说话很快的纽约人
  • chill_surfer -悠闲、醇厚、毫不费力地凉爽
  • cheerleader -精力充沛、热情、有动力
  • emo_teenager -讽刺、无私、忧郁
  • eternal_optimist -积极、以解决方案为导向
  • dramatic -低沉、安静、悬疑，富有戏剧性

🎵 使用示例

  • “使用文本转语音来解释此代码”
  • “读一下你刚才做的更改”
  • “列出我的音频设备”
  • “切换到专业声音风格”

📚 全部文件

有关高级配置、语音预设、故障排除和开发设置，请参阅 SETUP_GUIDE.md.

状态： ✅ 使用Cursor IDE•🎵 7个TTS工具可用•🔊 跨平台音频•🧩 提供商：OpenAI、ElevenLabs

🛠️ 可用工具

此MCP服务器在Cursor中提供以下工具：

  • 文本到语音 --将文本转换为语音，并使用当前配置通过扬声器播放。
  • 列表_音频_设备 --列出系统上所有可用的音频输出设备。
  • 测试_音频_设备 --在选定的音频设备上播放测试音以验证其是否正常工作。
  • 停车_停车 --立即停止任何当前语音播放。
  • get_tts_status --显示当前TTS服务器状态、提供商、卷和设备信息。
  • get_current配置 --显示当前语音、预设、设备和所有活动TTS设置。
  • set_volume --更改语音输出的播放音量。

相关 MCP