MCP.so
登录

mcp-say

@blacktop

代码仓库

关于 mcp-say

MCP Server for Text to Speech

#golang#text-to-speech#mcp#tts#say#elevenlabs#mcp-server

基本信息

分类

其他

许可证

MIT

运行时

go

传输方式

stdio

发布者

blacktop

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-say": {
      "command": "npx",
      "args": [
        "skills",
        "add",
        "https://github.com/blacktop/mcp-tts",
        "--skill",
        "speak"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is mcp-say?

mcp-say is an MCP server that adds text-to-speech capabilities to AI assistants like Claude Desktop and Cursor IDE. It provides four tools: say_tts (macOS built-in), elevenlabs_tts, google_tts, and openai_tts, each offering different voices and options.

How to use mcp-say?

Install via go install github.com/blacktop/mcp-tts@latest. Configure in Claude Desktop's claude_desktop_config.json or via command line for Claude Code, Codex CLI, or Gemini CLI. Set required API keys as environment variables. Invoke by calling the appropriate TTS tool (e.g., say_tts, openai_tts) through the MCP protocol.

Key features of mcp-say

  • Four TTS providers: macOS say, ElevenLabs, Google Gemini, OpenAI
  • Sequential (default) or concurrent speech via --sequential-tts flag
  • Save audio to disk with MCP_TTS_OUTPUT_DIR and optional --no-play
  • Suppress "Speaking:" output with MCP_TTS_SUPPRESS_SPEAKING_OUTPUT
  • OpenAI TTS supports speed control (0.25x–4.0x) and custom voice instructions
  • Multi-instance protection prevents overlapping speech across Claude Desktop instances

Use cases of mcp-say

  • Enable an AI assistant to read responses aloud for accessibility
  • Add voice feedback to automated workflows or agents
  • Generate audio files programmatically from text
  • Test and compare different TTS providers in one tool

FAQ from mcp-say

Which API keys are required?

ElevenLabs API key for elevenlabs_tts, Google AI API key for google_tts, and OpenAI API key for openai_tts. The say_tts tool uses macOS built-in and requires no API key.

Can I use mcp-say on Windows or Linux?

The say_tts tool relies on the macOS say binary and works only on macOS. The other three cloud-based tools (ElevenLabs, Google, OpenAI) are platform-independent.

How do I prevent overlapping speech?

By default, TTS requests are sequential—only one plays at a time. Set MCP_TTS_ALLOW_CONCURRENT=true or use --sequential-tts=false to allow concurrent speech.

Can I save the audio to a file instead of playing it?

Yes. Set MCP_TTS_OUTPUT_DIR to a directory path. Optionally set MCP_TTS_NO_PLAY=true to skip playback and only save the file. Files are named tts_{timestamp}_{hash}.{ext} with formats AIFF (say), MP3 (ElevenLabs/OpenAI), WAV (Google).

What is the behavior for free-tier ElevenLabs API keys?

Free-tier ElevenLabs API keys can only use premade voices. Voice Library (community/professional) voices will return a 402 paid_plan_required error.

评论

其他 分类下的更多 MCP 服务器

🪟 Windows-MCP

CursorTouch

MCP Server for Computer Use in Windows

6.3K

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Servers

modelcontextprotocol

Model Context Protocol Servers

88.2K