FreeTTS

FreeTTS MCP 服务

在 Claude、ChatGPT、Cursor、VS Code、Codex、Windsurf、Gemini CLI 和任何其他 MCP 客户端中进行文本转语音。一个远程服务，无需安装：

https://mcp.freetts.org/mcp

让助手朗读内容，它就会调用 FreeTTS 并提供 MP3 链接。

功能

工具	功能	要求
text_to_speech	输入文本，输出 MP3 链接。支持 149 种语言的 2,253 个语音。	无。无需账户即可免费使用。
list_voices	按语言或搜索词查找语音，并显示语音 ID。	无
suggest_voice	根据语言和用途推荐 3 个语音，并说明理由。	无
check_usage	查看方案和剩余字符数。	无
dialogue_to_speech	输入 Name: line 脚本，为每位说话者指定一个语音，生成一个文件。	FreeTTS PRO
script_to_tracks	脚本模式：支持精确的 (pause 2)、(beep)、(ding)、TRACK: 文件、CUE: 语音和场景。	FreeTTS PRO
transcribe_audio	输入公开音频 URL，输出文本。	FreeTTS PRO

**无需密钥即可免费使用：**标准语音，每次调用和每天每个连接可处理 2,000 个字符，每分钟 10 个请求，结尾附带一段简短的语音「FreeTTS」标记，文件保留 1 小时。

使用 FreeTTS 密钥（免费账户或 PRO）：适用账户所属方案。PRO：HD 和 Signature 语音，无标记，每次调用可处理 10,000 个字符，每月可处理 1,000,000 个字符，支持 WAV，文件保留 30 天，并可使用对话、脚本模式和转录工具。密钥获取地址：freetts.org/dashboard（API 密钥）。

添加到客户端

Claude Code

claude mcp add --transport http freetts https://mcp.freetts.org/mcp

使用密钥：添加 --header "Authorization: Bearer ft_live_..."，或在会话中运行 /mcp，通过登录流程进行连接。

**Claude（网页、桌面、移动端）：**依次选择「设置」「连接器」「添加自定义连接器」，粘贴 https://mcp.freetts.org/mcp。免费工具可立即使用；需要账户的工具会让 Claude 显示「连接」选项。

Cursor：在 Cursor 中安装，或在 ~/.cursor/mcp.json 中添加：

{ "mcpServers": { "freetts": { "url": "https://mcp.freetts.org/mcp" } } }

VS Code：在 VS Code 中安装，或在 .vscode/mcp.json 中添加：

{ "servers": { "freetts": { "type": "http", "url": "https://mcp.freetts.org/mcp" } } }

Codex CLI 和 ChatGPT 桌面应用

codex mcp add freetts --url https://mcp.freetts.org/mcp

**ChatGPT（网页）：**依次选择「设置」「应用」（开发者模式），添加 https://mcp.freetts.org/mcp。

Windsurf，在 ~/.codeium/windsurf/mcp_config.json 中添加：

{ "mcpServers": { "freetts": { "serverUrl": "https://mcp.freetts.org/mcp" } } }

**其他客户端：**将 https://mcp.freetts.org/mcp 用作服务 URL（Streamable HTTP）。若要在不使用登录流程的情况下使用账户，请将密钥作为 Authorization: Bearer ft_live_... 或 x-api-key: ft_live_... 发送。

完整指南（含复制按钮）：freetts.org/developers/mcp。

登录（OAuth）

此服务是一个 OAuth 2.1 授权服务器（PKCE、动态客户端注册、客户端 ID 元数据文档、RFC 9728 和 8414 元数据）。免费工具无需登录。当客户端调用需要账户的工具时，服务会返回 401，客户端会显示连接流程；随后页面会要求提供来自控制面板的 FreeTTS API 密钥，并将连接绑定到该密钥。在控制面板中删除密钥，即可断开所有使用过该密钥的助手。

隐私

你发送的文本会发送给 FreeTTS 及其语音服务提供商，处理方式与网站完全相同，并遵循 FreeTTS 隐私政策。不带密钥的调用会按调用者的 IP 地址计量。服务会记录工具名称、方案、字符数、客户端名称和调用结果，但绝不记录文本。

本地运行（stdio）

同一服务也可以在你自己的机器上运行，适用于会启动本地服务的客户端，或你希望将密钥保存在本地配置中的情况。它会使用你自己的密钥调用公共 FreeTTS API。可在 freetts.org/dashboard 获取密钥（API 密钥；免费账户可获取一个）。

FREETTS_API_KEY=ft_live_... npx -y @freetts/mcp

Claude Desktop、Cursor、Cline、Windsurf 等类似客户端：

{
  "mcpServers": {
    "freetts": {
      "command": "npx",
      "args": ["-y", "@freetts/mcp"],
      "env": { "FREETTS_API_KEY": "ft_live_..." }
    }
  }
}

即使没有密钥，服务仍会启动：list_voices、suggest_voice、提示词和资源都可以使用，生成音频时则会要求提供密钥。托管服务 https://mcp.freetts.org/mcp 完全不需要密钥。

从源代码运行：npm install && npm run build && node dist/stdio.js。需要 Node.js 20 或更高版本。

托管服务本身（dist/index.js）与 FreeTTS API 一起运行在 FreeTTS 自己的机器上，不适合自托管；提供此代码是为了让你确切了解它的运行方式。

许可证：MIT。