About Voice MCP
Voice MCP is an MCP server in the Content category: voice I/O for Claude Desktop via M5Stack — mcp.log watcher + VOICEVOX/Kokoro TTS push playback.
The repository has 17 stars and 0 forks.
Install
git clone https://github.com/garan0613/voice-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Voice MCP
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
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 MINIMAX_GROUP_ID
npx wrangler secret put VOICE_ID
npx wrangler secret put BOT_NAME # Optional, defaults to "AI"
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 |
MINIMAX_GROUP_ID |
✅ | Your MiniMax group ID |
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
- ext-apps — Inline UI rendering
License
MIT © 2026
Credits
Inspired by the need to give AI assistants a voice. Built with ❤️
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.