Skip to main content
Glama

🎙️ voice-mcp

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

License

기능

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

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

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

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

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

Related MCP server: voice-mcp

데모

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

구성

변수

필수

설명

ELEVENLABS_API_KEY

✅

ElevenLabs API 키

ELEVENLABS_VOICE_ID

✅

ElevenLabs 음성 ID

ELEVENLABS_MODEL_ID

❌

기본값은 eleven_multilingual_v2입니다

BOT_NAME

❌

표시 이름 (기본값: "AI")

API 엔드포인트

엔드포인트

설명

GET /mcp

MCP 서버 (스트리밍 HTTP)

GET /sse

MCP 서버 (SSE 호환 엔드포인트)

GET /speak?text=Hello

직접 오디오 파일

GET /status

상태 확인

음성 선택하는 방법

  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 전송을 직접 처리

기술 스택

라이선스

MIT © 2026

크레딧

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers