🎙️ voice-mcp

인라인 오디오 플레이어를 갖춘 AI 음성 합성용 MCP(Model Context Protocol) 서버입니다. AI 어시스턴트에게 맞춤 복제 음성을 부여해 보세요!

기능

• 🎤 맞춤 음성 — 선택하거나 복제한 음성으로 ElevenLabs를 사용합니다

• 🎵 인라인 오디오 플레이어 — 웨이브폼 시각화가 포함된 세련된 WeChat 스타일 플레이어

• 📝 대본 표시 전환 — 말소리 텍스트를 표시하거나 숨깁니다

• 🌙 다크 모드 지원 — 자동 테마 적응

• ⚡ Cloudflare Workers — 빠른 서버리스 배포

Related MCP server: ElevenLabs MCP Server

데모

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는 후자를 사용합니다.

구성

API 엔드포인트

음성 선택하는 방법

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. createMcpHandler를 표준 HTTP/SSE 핸들러로 교체

2. @modelcontextprotocol/sdk를 직접 사용

3. SSE 전송을 직접 처리

기술 스택

• Cloudflare Workers — 서버리스 런타임

• MCP SDK — Model Context Protocol

• ElevenLabs — 음성 합성

• ext-apps — 인라인 UI 렌더링

라이선스

MIT © 2026

크레딧

AI 어시스턴트에게 음성을 제공하고자 하는 필요에서 시작되었습니다. ❤️로 만든 프로젝트입니다.