{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_k2xvcy933fm8","handle":"yuppie-mcp-tts","url":"https://wellknown.network/agents/yuppie-mcp-tts","links":{"self":"https://wellknown.network/agents/yuppie-mcp-tts/record.json","html":"https://wellknown.network/agents/yuppie-mcp-tts","markdown":"https://wellknown.network/agents/yuppie-mcp-tts/record.md","api":"https://wellknown.network/api/v1/agents/yuppie-mcp-tts","status":"https://wellknown.network/api/v1/agents/yuppie-mcp-tts/status","claim":"https://wellknown.network/agents/yuppie-mcp-tts/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/yuppie-mcp-tts/claim.json","badge":"https://wellknown.network/agents/yuppie-mcp-tts/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/yuppie-mcp-tts/history","tools":"https://wellknown.network/api/v1/agents/yuppie-mcp-tts/tools"},"ard":{"identifier":"urn:air::server:yuppie-mcp-tts","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"yuppie-mcp-tts","summary":"MCP Server for Text-to-Speech (edge-tts) — no API key required","description":"# yuppie-mcp-tts\n\nTTS (文字转语音) MCP Server — 基于 [edge-tts](https://github.com/rany2/edge-tts) (微软 Edge 免费 TTS 引擎)，无需 API Key，无需配置。\n\n## 功能\n\n| 工具名 | 说明 |\n|--------|------|\n| `text_to_speech` | 文字转语音，返回 base64 MP3 音频（可选嗓音、语速） |\n| `list_voices` | 列出 50+ 可用嗓音（中英文等多语种） |\n| `text_to_speech_file` | 文字转语音并保存为 MP3 文件到磁盘 |\n\n**参数说明：**\n- `voice`: 嗓音名称，如 `en-US-JennyNeural`、`zh-CN-XiaoxiaoNeural`，默认 `en-US-JennyNeural`\n- `speed`: 语速倍率 0.1~3.0，1.0 为正常速度\n\n## 架构说明\n\n本包是 MCP 壳：核心 TTS 合成逻辑在库包 `yuppie-tts`（PyPI 分发，`pip install yuppie-tts`），本包依赖它。\n\n如只需在 Python 项目中合成语音（不要 MCP），直接装库包：\n\n```bash\nuv pip install yuppie-tts\n```\n\n## 只需要 TTS 库？（无 MCP）\n\n本包是 MCP 壳：核心合成逻辑在库包 `yuppie-tts`（PyPI 分发，`pip install yuppie-tts`），本包依赖它。\n\n如只需在 Python 项目中合成语音（不要 MCP），直接装库包：\n\n```bash\npip install yuppie-tts\n```\n\n```python\nimport asyncio\nfrom yuppie_tts import synthesize\n\nasync def main():\n    audio = await synthesize(\"你好世界\", voice=\"zh-CN-XiaoxiaoNeural\")\n    with open(\"/tmp/output.mp3\", \"wb\") as f:\n        f.write(audio)\n\nasyncio.run(main())\n```\n\n## 快速开始\n\n### 安装\n\n```bash\npip install yuppie-mcp-tts\n```\n\n### 运行\n\n```bash\nyuppie-mcp-tts\n```\n\n无需任何配置，开箱即用。\n\n## MCP 集成\n\n### Claude Code\n\n在 `.mcp.json` 中添加：\n\n```json\n{\n  \"mcpServers\": {\n    \"yuppie-mcp-tts\": {\n      \"type\": \"stdio\",\n      \"command\": \"uvx\",\n      \"args\": [\"--refresh\", \"yuppie-mcp-tts\"]\n    }\n  }\n}\n```\n\n### Cursor / Cherry Studio / Claude Desktop / OpenCode\n\n```json\n{\n  \"mcpServers\": {\n    \"yuppie-mcp-tts\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--refresh\", \"yuppie-mcp-tts\"]\n    }\n  }\n}\n```\n\n## 可用嗓音\n\n50+ 嗓音覆盖多种语言和地区变体：\n\n**英语 (US):** JennyNeural, GuyNeural, AriaNeural, DavisNeural, JaneNeural, JasonNeural, NancyNeural, SaraNeural, TonyNeural\n\n**英语 (UK):** SoniaNeural, RyanNeural, LibbyNeural, MaisieNeural\n\n**英语 (AU):** NatashaNeural, WilliamNeural\n\n**英语 (CA):** ClaraNeural, LiamNeural\n\n**英语 (IN):** NeerjaNeural, PrabhatNeural\n\n**中文:** XiaoxiaoNeural, YunxiNeural, YunjianNeural, XiaoyiNeural, YunyangNeural\n\n**其他:** 法语、德语、日语、韩语、葡萄牙语、西班牙语等\n\n使用 `list_voices` 工具…","publisher":null,"homepage":"https://github.com/yuppie1949/yuppie-mcp-tts","repository":"https://github.com/yuppie1949/yuppie-mcp-tts","version":"0.3.0","license":null,"protocols":["mcp"],"tags":["edge-tts","mcp","model-context-protocol","text-to-speech","tts"],"pricing":null,"endpoints":[{"url":"pypi:yuppie-mcp-tts","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"media.speech-synthesis","name":"Speech Synthesis","confidence":1,"provenance":"declared"}],"categories":["media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"yuppie-mcp-tts","registry":"pypi","observedAt":"2026-10-23T00:27:51.230Z","publishedAt":"2026-08-29T06:07:27.354073Z","latestVersion":"0.3.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"yuppie-mcp-tts","url":"https://pypi.org/project/yuppie-mcp-tts/","firstSeenAt":"2026-09-10T16:23:40.678Z","fetchedAt":"2026-10-23T00:26:31.817Z","normalizedAt":"2026-10-23T00:26:31.817Z"}]},"firstSeenAt":"2026-09-10T16:23:40.678Z","updatedAt":"2026-10-23T00:27:51.230Z"}