GV

garan0613/voice-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

48 stars 58 forks 품질 71 트렌드 21MIT

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에 연결

  1. ** 설정 → 커넥터 → 커넥터 추가 **
  2. 노동자 URL을 입력하십시오: https://your-worker.workers.dev/mcp
  3. 끝난! 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

  1. Go to Settings → Connectors → Add Connector
  2. Enter your Worker URL: https://your-worker.workers.dev/mcp
  3. Done! The speak tool 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

  1. Go to MiniMax Console
  2. Navigate to Voice Cloning
  3. Upload 10-30 seconds of clear audio
  4. Wait for processing (usually a few minutes)
  5. Copy the Voice ID

Custom Deployment

Using a Custom Domain

  1. Add your domain to Cloudflare
  2. Create a DNS record pointing to your Worker
  3. 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:

  1. Replace createMcpHandler with a standard HTTP/SSE handler
  2. Use @modelcontextprotocol/sdk directly
  3. Handle the SSE transport yourself

Tech Stack

GitHub에서 전체 README 보기

설치

npx wrangler secret put MINIMAX_API_KEY
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →