
garan0613/voice-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
garan0613/voice-mcp - кандидат на сервер MCP, импортированный из https://github.com/garan0613/voice-mcp.
Обзор
garan0613/voice-mcp - кандидат на сервер MCP, импортированный из https://github.com/garan0613/voice-mcp.
Обзор (машинный перевод)
Сервер MCP (Model Context Protocol) для синтеза голоса AI с встроенным аудиоплеером. Дайте своему помощнику искусственный интеллект клонированный голос!
Особенности
Custom Voice Cloning — Используйте MiniMax TTS API с собственным клонированным голосом Inline Audio Player — красивый плеер в стиле WeChat с визуализацией формы волны Transcript Toggle — Показать/скрыть устный текст ** Поддержка темного режима** - Автоматическая адаптация темы Cloudflare Workers — быстрое, бессерверное развертывание
Демо
Когда вы звоните speak, вы получаете:
- Гладкий аудиоплеер с кнопкой воспроизведения/паузы
- Анимированная форма волны, которая следует за прогрессом воспроизведения
- Длительность показа Расширяемая транскрипция
Быстрый старт
###1.Клонировать репозиторий
###2 Установите зависимость
###3 Конфигурация MiniMax API
Вам понадобится учетная запись MiniMax с включенным клонированием голоса.
Добавьте свои секреты в Cloudflare:
Текущая аутентификация MiniMax T2A использует только ключ API. GroupId больше не требуется.
###4. Развернуть
###5.Подключайтесь к Claude.ai
1.Перейти к Настройки → Коннекторы → Добавить Коннектор
2.Введите свой рабочий URL: https://your-worker.workers.dev/mcp
3.Сделано! Инструмент speak уже доступен.
Конфигурация
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
🎙️ voice-mcp
An MCP (Model Context Protocol) server for AI voice synthesis with an inline audio player. Give your AI assistant a custom cloned voice!
Features
- 🎤 Custom Voice Cloning — Use MiniMax TTS API with your own cloned voice
- 🎵 Inline Audio Player — Beautiful WeChat-style player with waveform visualization
- 📝 Transcript Toggle — Show/hide the spoken text
- 🌙 Dark Mode Support — Automatic theme adaptation
- ⚡ Cloudflare Workers — Fast, serverless deployment
Demo
When you call the speak tool, you get:
- A sleek audio player with play/pause button
- Animated waveform that follows playback progress
- Duration display
- Expandable transcript
Quick Start
1. Clone the repository
git clone https://github.com/garan0613/voice-mcp.git
cd voice-mcp
2. Install dependencies
npm install
3. Configure MiniMax API
You’ll need a MiniMax account with voice cloning enabled.
Add your secrets to Cloudflare:
npx wrangler secret put MINIMAX_API_KEY
npx wrangler secret put VOICE_ID
npx wrangler secret put BOT_NAME # Optional, defaults to "AI"
Current MiniMax T2A authentication uses the API key only. GroupId is no longer required.
4. Deploy
npx wrangler deploy
5. Connect to Claude.ai
- Go to Settings → Connectors → Add Connector
- Enter your Worker URL:
https://your-worker.workers.dev/mcp - Done! The
speaktool is now available.
Configuration
| Variable | Required | Description |
|---|---|---|
MINIMAX_API_KEY |
✅ | Your MiniMax API key |
VOICE_ID |
✅ | The cloned voice ID |
BOT_NAME |
❌ | Display name (default: “AI”) |
API Endpoints
| Endpoint | Description |
|---|---|
GET /mcp |
MCP server (SSE protocol) |
GET /speak?text=Hello |
Direct audio file |
GET /status |
Health check |
How to Clone a Voice
- Go to MiniMax Console
- Navigate to Voice Cloning
- Upload 10-30 seconds of clear audio
- Wait for processing (usually a few minutes)
- Copy the Voice ID
Custom Deployment
Using a Custom Domain
- Add your domain to Cloudflare
- Create a DNS record pointing to your Worker
- Update
wrangler.jsonc:
{
"routes": [
{ "pattern": "voice.yourdomain.com/*", "zone_name": "yourdomain.com" }
]
}
Self-Hosting (Node.js)
The core MCP logic can be adapted for other platforms. You’ll need to:
- Replace
createMcpHandlerwith a standard HTTP/SSE handler - Use
@modelcontextprotocol/sdkdirectly - Handle the SSE transport yourself
Tech Stack
- Cloudflare Workers — Serverless runtime
- MCP SDK — Model Context Protocol
- MiniMax TTS — Voice synthesis
Установка
npx wrangler secret put MINIMAX_API_KEY