接入文档

REST API 直调 · MCP · Skill 一键安装

什么是 MCP

Model Context Protocol 是 Anthropic 推动的标准协议，让 AI Agent / IDE 客户端（Claude Desktop、Cursor、Continue 等）通过统一接口接入外部工具。

Vox 直接把 MCP 服务挂在了一个 HTTPS endpoint 上：https://vox.timor419.com/mcp。**无需 npm install / 不下载客户端**，配一个 URL 就能用。

配置

1. 拿 API key

没有 key？去 https://vox.timor419.com/get-key 跟着流程走。已登录用户从控制台「API key」面板复制以 JK 开头的 key 即可。

2. Claude Desktop

打开 Claude Desktop → Settings → Developer → Edit Config，加入：

json

{
  "mcpServers": {
    "vox": {
      "type": "http",
      "url": "https://vox.timor419.com/mcp",
      "headers": {
        "Authorization": "Bearer JK********"
      }
    }
  }
}

把 JK******** 换成你刚才复制的 key。重启 Claude Desktop。tool 选择器里会出现 tts / voices / balance。

3. Cursor / Continue / 其他 MCP 客户端

支持 Streamable HTTP transport 的客户端配置基本一样：

json

{
  "mcpServers": {
    "vox": {
      "url": "https://vox.timor419.com/mcp",
      "headers": {
        "Authorization": "Bearer JK********"
      }
    }
  }
}

Cursor 配置文件路径：~/.cursor/mcp.json。其他客户端的配置入口查各自文档。

Tool 列表

tts

把中文（或带英文混合）文本合成为自然真人语音。

字段	类型	必填	说明
text	string	是	1-2000 字符
voice_id	string	否	省略则用 voices 列表里的第一个（平台当前推荐）

返回一段文本，包含 mp3 公网 URL（浏览器打开即可播放）+ 音色 / 字符消耗 / 余额。对应 REST POST /api/v1/tts。

voices

列出当前所有可用音色 ID。无需 API key。精选音色（前面带 ★ 标记）排在最前，方便 agent 直接用前几个作默认推荐。对应 REST GET /api/v1/voices。

balance

查询当前 API key 的余额。零扣费。对应 REST GET /api/v1/balance。