TTSForFree

TTSForFree MCP 服务

为 Claude 和任何其他 MCP 客户端提供文本转语音、多角色播客、字幕配音、转录和视频配音。提供 100 多种语言的数千种 AI 语音，并以托管 MP3 URL 的形式返回。

• 服务 URL： https://api.ttsforfree.com/mcp（Streamable HTTP，远程，无需安装）
• 登录： OAuth。点击 连接 并登录 TTSForFree。无需 API 密钥。API 密钥（X-API-Key 标头）也可用于脚本和 Agent。
• 注册表： io.github.CalmNguyen/ttsforfree
• 网站： ttsforfree.com · 设置指南： ttsforfree.com/en/claude-tts-connector

包含免费套餐。付费生成会消耗 TTSForFree 积分。

连接

Claude（claude.ai、桌面版、移动版）

1. 设置 → 连接器 → 添加自定义连接器
2. URL：https://api.ttsforfree.com/mcp
3. 点击 连接，登录 TTSForFree 并允许访问。

Claude Code

claude mcp add --transport http ttsforfree https://api.ttsforfree.com/mcp

然后运行 /mcp → ttsforfree → Authenticate。使用 API 密钥时：

claude mcp add --transport http ttsforfree https://api.ttsforfree.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Cursor、VS Code 和其他客户端

{
  "mcpServers": {
    "ttsforfree": {
      "url": "https://api.ttsforfree.com/mcp"
    }
  }
}

如果客户端不支持 OAuth，请添加 "headers": { "X-API-Key": "YOUR_API_KEY" }。 在 ttsforfree.com/en/profile 获取 API 密钥。

Claude API（MCP 连接器）

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 2048,
    "mcp_servers": [{
      "type": "url",
      "name": "ttsforfree",
      "url": "https://api.ttsforfree.com/mcp",
      "authorization_token": "YOUR_TTSFORFREE_API_KEY"
    }],
    "tools": [{ "type": "mcp_toolset", "mcp_server_name": "ttsforfree" }],
    "messages": [{ "role": "user", "content": "Read this in a warm British voice: Welcome to our channel!" }]
  }'

可以提出的请求

向 Claude 提出请求	使用的工具
“用我收藏的沉稳英式语音朗读这节课程。”	list_favorite_voices → text_to_speech
“把这篇文章制作成由 2 位主持人播讲的播客，并生成一个 MP3。”	multi_voice_to_speech → get_job_detail
“将这个 SRT 翻译成西班牙语，保留时间戳，配上语音，并给我 ffmpeg 命令。”	srt_to_speech → get_job_status
“将这个视频转录成 SRT 文件。”	create_upload_url → transcribe_media
“先计算费用，再将这个视频配成越南语、西班牙语和日语版本，用于 YouTube。”	create_upload_url → estimate_video_localization → localize_video → get_localization_status
“帮我制作一个年轻的男性语音，用来讲评故事，带有越南南部口音。”	design_custom_voice

视频演示：ttsforfree.com/en/claude-tts-connector。

工具（21）

工具	类型	功能
list_languages	读取	所有受支持的语言及其代码。
list_voices	读取	按语言、性别、提供方和关键词（“温暖的旁白者”）搜索声音。
get_voice_details	读取	查看某个声音的角色设定、使用场景、口音、风格、试听音频和积分费用。
list_favorite_voices	读取	用户收藏的声音，按保存顺序排列。
list_my_custom_voices	读取	通过 Voice Design / Voice Clone 创建的个人声音及剩余配额。
add_favorite_voice	写入	将声音添加到收藏。
remove_favorite_voice	写入	从收藏中移除声音。
design_custom_voice	写入	根据文字描述创建新的个人声音。
get_account_status	读取	套餐、剩余积分、每次请求的限制和 API 速率限制。
text_to_speech	任务	一段文本 + 一个声音 → MP3（旁白、文章、课程）。
multi_voice_to_speech	任务	按顺序排列的不同声音片段 → 一个 MP3（播客、对话）。
srt_to_speech	任务	SRT/WebVTT 或带时间的片段 → 与时间轴对齐的 MP3 + ffmpeg 合并命令。
get_job_status	读取	轮询任务，直到状态为 SUCCESS，并获取音频 URL。
list_recent_jobs	读取	查看近期任务及其音频 URL，以便重复使用，避免重复付费。
get_job_detail	读取	获取多声音/SRT 任务中每个片段的音频（适用于 Remotion 和字幕）。
create_upload_url	写入	为本地视频/音频文件创建一次性上传 URL（PUT，最大 2 GB）。
transcribe_media	任务	视频/音频 → 带时间戳的 SRT（语音转文字）。
get_transcription	读取	查看转录状态和 SRT。
estimate_video_localization	读取	估算将视频配音为多种语言所需的积分。
localize_video	任务	将一个视频配音为多种语言：为每种语言生成音轨和配音视频。
get_localization_status	读取	查看每种语言的进度和结果（YouTube 音频 URL、配音视频、SRT）。

job 工具是异步的：它们会返回一个 job_id，客户端会轮询对应的状态工具，直到状态为 SUCCESS。

提示词： youtube_multi_language_audio、video_voiceover、podcast_episode、narrate_text。

隐私和数据

• OAuth 访问权限仅限于你的 TTSForFree 账户，并且可以随时从 TTSForFree 个人资料中的“已连接的应用”撤销。
• 文本、字幕和上传的媒体仅用于生成你所请求的音频、字幕或视频。
• 隐私政策：ttsforfree.com/en/privacy-policy

支持

在此代码库中提交 issue，或通过 ttsforfree.com/en/contact 联系我们。

注册表元数据

server.json 是发布到 MCP Registry 的条目。要发布更新，请提升 server.json 中的 version 并推送一个标签 vX.Y.Z（或手动运行 Publish to MCP Registry 工作流）。该工作流使用 GitHub OIDC 登录，因此无需密钥。