
garan0613/voice-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
garan0613/voice-mcp는 https://github.com/garan0613/voice-mcp.에서 수입된 MCP 서버 후보입니다
개요
garan0613/voice-mcp는 https://github.com/garan0613/voice-mcp.에서 수입된 MCP 서버 후보입니다
개요(AI 번역)
MCP(Model Context Protocol) 서버는 인라인 오디오 플레이어와 AI 음성 합성 서버입니다. 당신의 AI 조수에게 관례에 의하여 복제되는 음성을 주십시오!
특징
- ≡ ** 사용자 정의 음성 복제 ** - MiniMax TTS API를 사용하여 복제 된 음성
- 8.9 ** 인라인 오디오 플레이어 ** - 파형 시각화가있는 아름다운 WeChat-style 플레이어
- ᄏᄏTranscript Toggle — 말하기 텍스트 표시
- 댄 Dark Mode Support - 자동 테마 적응
- ⚡Cloudflare Workers - 빠른 서버 배포
데모
speak] 도구를 호출하면 다음을 얻을 수 있습니다.
- 재생 / 일시 버튼이있는 세련된 오디오 플레이어
- 재생 진행 상황을 따르는 애니메이션 파형
- 기간 표시
- 확장 가능한 성적
빠른 시작
##1. 저장소를 복제
##2. 의존성 설치
##3. MiniMax API 구성
MiniMax 계정은 음성 복제 활성화가 필요합니다.
비밀을 Cloudflare에 추가하십시오.
현재 MiniMax T2A 인증은 API 키만 사용합니다. GroupId는 더 이상 필요하지 않습니다.
##4. 배포
5. Claude.ai에 연결
- ** 설정 → 커넥터 → 커넥터 추가 **
- 노동자 URL을 입력하십시오:
https://your-worker.workers.dev/mcp - 끝난!
speak도구는 지금 사용할 수 있습니다.
구성
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
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