tts

Brainiall TTS MCP 服务

通过模型上下文协议为 AI Agent 提供托管式文本转语音服务。

54 种神经语音，支持 9 种语言——包括原生的巴西葡萄牙语（pf_dora、pm_alex、pm_santa），由托管式按量付费 API 提供。无需 GPU、无需下载模型，也无需订阅 ElevenLabs：只需一个 API 密钥，每 1,000 个字符仅需 $0.008（注册即可获赠 $10 免费额度）。

为什么选择此服务

其他所有 TTS MCP 服务要么在本地运行模型（资源占用大，设置耗时），要么封装你已经付费订阅的第三方密钥。此服务是一个托管式按量计费 API：

• 零配置——远程服务，无需安装
• 按量付费——每 1K 个字符 $0.008，从你的 Brainiall 余额中扣费
• $10 免费额度——在 app.brainiall.com 注册
• WAV 输出——16 位 PCM、24 kHz 单声道，以可播放的 MCP 音频内容或 base64 JSON 格式返回

快速开始

在 app.brainiall.com 获取 API 密钥（赠送 $10 欢迎额度，无需银行卡）。

VS Code / GitHub Copilot

此按钮会以发现模式安装远程服务，因此 VS Code 无需密钥即可列出其工具。添加 Brainiall API 密钥之前，语音合成请求仍会被拒绝。若要使用安全的工作区配置，只需输入一次密钥并将其存储在 VS Code 的机密存储中，请将 .vscode/mcp.json 复制到你的项目，或克隆此代码仓库，然后从 MCP: List Servers 启动 brainiallTts。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "brainiall-api-key",
      "description": "Brainiall API key",
      "password": true
    }
  ],
  "servers": {
    "brainiallTts": {
      "type": "http",
      "url": "https://api.brainiall.com/mcp/tts/mcp",
      "headers": {
        "Authorization": "Bearer ${input:brainiall-api-key}"
      }
    }
  }
}

服务启动后，试试：

使用 Brainiall TTS 列出巴西葡萄牙语语音，然后用 pf_dora 朗读“Olá do VS Code”。

安装 URL 格式和机密输入配置遵循 VS Code 官方 MCP 指南和配置参考。

GitHub Copilot 云 Agent

对于 Copilot 云 Agent 或 Copilot 代码审查，请使用受限远程服务配置。该配置仅允许使用 Brainiall 的三个工具，并从代码仓库的 COPILOT_MCP_BRAINIALL_API_KEY Agents 机密中读取 Bearer 令牌；不会提交 API 密钥。

Continue（VS Code / JetBrains）

将可直接使用的 Continue MCP 配置块 复制到 .continue/mcpServers/brainiall-tts.yaml，然后将 BRAINIALL_API_KEY=your-key 写入 .continue/.env。请确保该 .env 文件不 纳入版本控制。

此配置块使用 Continue 支持的 streamable-http 传输，并通过 ${{ secrets.BRAINIALL_API_KEY }} 读取密钥；不会提交任何凭据。 请参阅 Continue 设置和冒烟测试。

Dify 构建者

若要构建 Dify 语音工作流，请使用开源的 BRAINIALL Speech provider，并将 API 密钥保存在 Dify 的凭据存储中。限定范围的 Dify 意图路由说明了由调用方负责的边界；这并不代表与 Dify 合作，也不保证在生产环境中的表现。

远程服务（推荐 — 无需安装）

Codex CLI / IDE / ChatGPT 桌面应用

使用项目级 Codex 配置。该配置会从环境中读取 BRAINIALL_API_KEY，将三个 Brainiall 工具加入允许列表， 并在每次调用前提示。

Claude Code

使用由环境提供的 Claude Code 配置。该配置不会将密钥写入 .mcp.json，将服务限定在当前项目范围内，并说明外部数据和按量计费的边界。

Claude Desktop / 任何采用 .mcp.json 风格配置的客户端

{
  "mcpServers": {
    "brainiall-tts": {
      "type": "http",
      "url": "https://api.brainiall.com/mcp/tts/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BRAINIALL_API_KEY"
      }
    }
  }
}

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "brainiall-tts": {
      "url": "https://api.brainiall.com/mcp/tts/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BRAINIALL_API_KEY"
      }
    }
  }
}

LM Studio

请使用官方的一键 deeplink，并参阅 LM Studio 设置指南中关于本地模型隐私边界的明确说明。

OpenCode v2

请使用 OpenCode v2 设置指南中的远程服务架构和由环境提供的 Bearer 标头。

Msty Studio

如需建立 Streamable HTTP 连接，请参阅 Msty Studio 手动配置指南。 此参考文件并非官方集成或导入预设。

Hugging Face Chat UI（可自托管）

请使用管理员 MCP_SERVERS 示例 和支持工具的模型。该指南说明了基础服务的共享密钥边界。

需要 /v1/audio/speech 的客户端

如果客户端可以配置 OpenAI 风格的语音路由，但无法调用 Brainiall 原生端点，请使用零依赖的部分兼容 OpenAI 格式的 TTS 适配器。该适配器仅返回 WAV，声明 WAV 标头中检测到的采样率，不会重试按量计费的请求，并说明了具体的兼容性限制。它是本地参考适配器，并不表示托管的 Brainiall API 原生兼容 OpenAI。

本地运行（不使用 stdio，仍会调用托管 API）

服务本身只是一个轻量封装 — 你可以自托管该服务，它会使用你的密钥将请求转发到 api.brainiall.com：

docker build -t brainiall-tts-mcp .
docker run -p 8080:8080 -e APIM_KEY=YOUR_BRAINIALL_API_KEY brainiall-tts-mcp
# MCP endpoint: http://localhost:8080/mcp

工具

工具	描述	费用
synthesize_speech	将文本（≤5000 个字符）转换为 WAV 语音。参数：text、language（默认值为 pt）、voice、speed（0.5–2.0）、output_format（audio | base64_json）	每 1K 个字符 $0.008
list_voices	完整的语音目录，包含语言、性别、口音和质量等级。可选的 language 筛选条件	免费
check_tts_service	后端运行状况	免费

语音

语言	语音
葡萄牙语（巴西）	pf_dora、pm_alex、pm_santa
英语（美国）	af_heart、af_bella、af_nova、am_adam、am_michael + 另外 14 个
英语（英国）	bf_alice、bf_emma、bm_daniel、bm_george + 另外 4 个
西班牙语	ef_dora、em_alex、em_santa
法语	ff_siwis、fm_gilles
意大利语	if_sara、im_nicola
印地语	hf_alpha、hf_beta、hm_omega、hm_psi
日语	jf_alpha、jf_gongitsune、jm_kumo + 另外 2 个
普通话	zf_xiaoxiao、zm_yunxi + 另外 6 个

示例

向你的 Agent 提问：

“用女性声音以巴西葡萄牙语朗读这段文字。”

Agent 会调用 synthesize_speech(text=..., language="pt", voice="pf_dora")，并收到可播放的 WAV 音频。

如需用于旁白、无障碍功能、语言练习和 Agent 提醒的可直接复制提示词与冒烟测试，请参阅 Agent 工作流示例。

如需测试 REST 客户端和自动化，请导入 Postman 集合。其中包含健康检查、语音列表和双角色合成冒烟测试，并将 API 密钥保存在集合变量中，而非请求 URL 中。

如需无代码自动化，请导入 n8n 文本转 WAV 工作流。它使用 n8n 的 Header Auth 凭据，而不是将密钥嵌入工作流中；会向托管 API 发送可编辑的文本、语音和语速字段，并将 WAV 返回到二进制属性 speech 中。该模板已通过静态验证；请在自己的 n8n 实例中选择凭据并运行，以验证实时集成。

如需生成代码、API 客户端和目录发现，请使用机器可读的 OpenAPI 3.1 规范。该规范记录了经过身份验证的语音目录和 WAV 合成端点，且未嵌入 API 密钥。

身份验证与计费

将你的 Brainiall API 密钥作为 Bearer token 传递（请参阅上方配置）。用量按字符计量，并从你的账户余额中扣除；同一个密钥可用于所有 Brainiall API（STT、OCR、NLP、图像等，详见 brainiall.com）。

端点

• MCP（Streamable HTTP）：https://api.brainiall.com/mcp/tts/mcp
• 健康检查：https://api.brainiall.com/mcp/tts/health
• 底层 REST API：POST https://api.brainiall.com/v1/tts/synthesize

许可证

MIT