Skip to main content
Glama

🎙️ voice-mcp

一个用于 AI 语音合成、配有内联音频播放器的 MCP(Model Context Protocol)服务器。为你的 AI 助手赋予自定义克隆音色!

License

功能特性

  • 🎤 自定义音色 — 使用 ElevenLabs 搭配选定或克隆的音色

  • 🎵 内联音频播放器 — 美观的微信风格播放器,带波形可视化

  • 📝 转录开关 — 显示/隐藏口播文本

  • 🌙 暗色模式支持 — 自动适应主题

  • ⚡ Cloudflare Workers — 快速、无服务器部署

Related MCP server: voice-mcp

演示

当你调用 speak 工具时,你将获得:

  • 带播放/暂停按钮的精巧音频播放器

  • 随播放进度动效的波形

  • 时间显示

  • 可展开的转录文本

快速开始

1. 克隆仓库

git clone https://github.com/p8j9k7psbk-hub/voice-mcp.git
cd voice-mcp

2. 安装依赖

npm install

3. 配置 ElevenLabs

创建一个 ElevenLabs API 密钥,并复制需要使用的音色的 ID。

将你的密钥添加到 Cloudflare:

npx wrangler secret put ELEVENLABS_API_KEY
npx wrangler secret put ELEVENLABS_VOICE_ID
npx wrangler secret put ELEVENLABS_MODEL_ID  # Optional; defaults to eleven_multilingual_v2
npx wrangler secret put BOT_NAME  # Optional, defaults to "AI"

4. 部署

npx wrangler deploy

5. 连接到 ChatGPT

  1. 在 ChatGPT 中启用开发者模式,然后从 + 菜单选择 创建应用。

  2. 添加公共 MCP URL:https://your-worker.workers.dev/mcp。

  3. 在对话中选择该应用。ChatGPT 即可调用 speak 工具并显示内联播放器。

该端点必须可通过 HTTPS 访问。ChatGPT 支持使用 SSE 或流式 HTTP 连接远程 MCP 服务器;此 Worker 采用后者。

配置

变量

必需

说明

ELEVENLABS_API_KEY

✅

你的 ElevenLabs API 密钥

ELEVENLABS_VOICE_ID

✅

ElevenLabs 音色 ID

ELEVENLABS_MODEL_ID

❌

默认为 eleven_multilingual_v2

BOT_NAME

❌

显示名称(默认值为 "AI")

API 端点

端点

说明

GET /mcp

MCP 服务器(流式 HTTP)

GET /sse

MCP 服务器(SSE 兼容端点)

GET /speak?text=Hello

直接获取音频文件

GET /status

健康检查

如何选择音色

  1. 打开 ElevenLabs Voice Library。

  2. 选择内置或克隆的音色。

  3. 将其音色 ID 粘贴到 ELEVENLABS_VOICE_ID。

自定义部署

使用自定义域名

  1. 将你的域名添加到 Cloudflare。

  2. 创建一条指向 Worker 的 DNS 记录。

  3. 更新 wrangler.jsonc:

{
  "routes": [
    { "pattern": "voice.yourdomain.com/*", "zone_name": "yourdomain.com" }
  ]
}

自行托管(Node.js)

核心 MCP 逻辑可以适配到其他平台。你需要:

  1. 用标准的 HTTP/SSE 处理器替换 createMcpHandler。

  2. 直接使用 @modelcontextprotocol/sdk。

  3. 自行处理 SSE 传输。

技术栈

许可证

MIT © 2026

鸣谢

灵感源自让 AI 助手有声音的需求。用 ❤️ 打造。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers