Skip to main content

yuppie-mcp-tts

TTS (文字转语音) MCP Server — 基于 edge-tts (微软 Edge 免费 TTS 引擎),无需 API Key,无需配置。

功能

工具名 说明
text_to_speech 文字转语音,返回 base64 MP3 音频(可选嗓音、语速)
list_voices 列出 50+ 可用嗓音(中英文等多语种)
text_to_speech_file 文字转语音并保存为 MP3 文件到磁盘

参数说明:

  • voice: 嗓音名称,如 en-US-JennyNeuralzh-CN-XiaoxiaoNeural,默认 en-US-JennyNeural
  • speed: 语速倍率 0.1~3.0,1.0 为正常速度

快速开始

安装

pip install yuppie-mcp-tts

运行

yuppie-mcp-tts

无需任何配置,开箱即用。

MCP 集成

Claude Code

.mcp.json 中添加:

{
  "mcpServers": {
    "yuppie-mcp-tts": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--refresh", "yuppie-mcp-tts"]
    }
  }
}

Cursor / Cherry Studio / Claude Desktop / OpenCode

{
  "mcpServers": {
    "yuppie-mcp-tts": {
      "command": "uvx",
      "args": ["--refresh", "yuppie-mcp-tts"]
    }
  }
}

可用嗓音

50+ 嗓音覆盖多种语言和地区变体:

英语 (US): JennyNeural, GuyNeural, AriaNeural, DavisNeural, JaneNeural, JasonNeural, NancyNeural, SaraNeural, TonyNeural

英语 (UK): SoniaNeural, RyanNeural, LibbyNeural, MaisieNeural

英语 (AU): NatashaNeural, WilliamNeural

英语 (CA): ClaraNeural, LiamNeural

英语 (IN): NeerjaNeural, PrabhatNeural

中文: XiaoxiaoNeural, YunxiNeural, YunjianNeural, XiaoyiNeural, YunyangNeural

其他: 法语、德语、日语、韩语、葡萄牙语、西班牙语等

使用 list_voices 工具可查看完整列表。

示例

用户: 把 "你好世界" 转成语音
AI: [调用 text_to_speech(text="你好世界", voice="zh-CN-XiaoxiaoNeural")]

用户: 把 "Hello World" 用英式发音保存到 /tmp/hello.mp3
AI: [调用 text_to_speech_file(text="Hello World", voice="en-GB-SoniaNeural", output_path="/tmp/hello.mp3")]

开发

uv pip install -e ".[dev]"
uv run pytest -v

本地调试

npx @modelcontextprotocol/inspector uv run yuppie-mcp-tts

许可证

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yuppie_mcp_tts-0.2.1.tar.gz (5.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yuppie_mcp_tts-0.2.1-py3-none-any.whl (7.5 kB view details)

Uploaded Python 3

File details

Details for the file yuppie_mcp_tts-0.2.1.tar.gz.

File metadata

  • Download URL: yuppie_mcp_tts-0.2.1.tar.gz
  • Upload date:
  • Size: 5.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.16 {"installer":{"name":"uv","version":"0.9.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for yuppie_mcp_tts-0.2.1.tar.gz
Algorithm Hash digest
SHA256 30cade48f6e378a799fa5aebd4060cbd7beb2fbe7470c9b86fc0f5763c3b1977
MD5 c29dcadd93d6f0c4be955491ad7ba3aa
BLAKE2b-256 90a3f7d0226fe2a8e699057b2caf981c181902e3fa41977647193d39b7fc4f91

See more details on using hashes here.

File details

Details for the file yuppie_mcp_tts-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: yuppie_mcp_tts-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 7.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.16 {"installer":{"name":"uv","version":"0.9.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for yuppie_mcp_tts-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 fd0d15a94c90f916e0cbc9883000479e09a871965f63a4731c20e1696c4bea5c
MD5 99416f4b59e7f246145c501c00488bfe
BLAKE2b-256 c69c09b1927d8e09a7a6a8a6ab2fa11bb9c3c9e36d3dcb4591bb1afbe8dc6336

See more details on using hashes here.

Release history Release notifications | RSS feed

0.3.0

2 files

This release

0.2.1 This release

2 files

0.2.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page