ElevenLabs MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables text-to-speech audio generation using ElevenLabs' API, supporting multiple voices, script parts with different speakers, audio file management, and voice history tracking.

  • Provides persistent storage for voice generation history, allowing retrieval and management of past text-to-speech jobs.

  • Includes a sample SvelteKit MCP Client for text-to-speech conversion, multi-part script management, and audio file playback and downloads.

ElevenLabs MCP 서버

ElevenLabs 텍스트-음성 API와 통합된 모델 컨텍스트 프로토콜(MCP) 서버로, 음성 생성 작업을 관리하기 위한 서버 구성 요소와 샘플 웹 기반 MCP 클라이언트(SvelteKit)를 모두 갖추고 있습니다.

특징

  • ElevenLabs API를 사용하여 텍스트에서 오디오 생성
  • 다양한 음성 및 스크립트 부분 지원
  • 영구적인 기록 저장을 위한 SQLite 데이터베이스
  • 샘플 SvelteKit MCP 클라이언트:
    • 간단한 텍스트-음성 변환
    • 다중 파트 스크립트 관리
    • 음성 기록 추적 및 재생
    • 오디오 파일 다운로드

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 ElevenLabs MCP 서버를 자동으로 설치하려면:

지엑스피1

uvx 사용(권장)

uvx 사용하면 특별한 설치가 필요하지 않습니다.

MCP 설정 파일에 다음 구성을 추가합니다(예: Claude Desktop의 경우 cline_mcp_settings.json ):

{ "mcpServers": { "elevenlabs": { "command": "uvx", "args": ["elevenlabs-mcp-server"], "env": { "ELEVENLABS_API_KEY": "your-api-key", "ELEVENLABS_VOICE_ID": "your-voice-id", "ELEVENLABS_MODEL_ID": "eleven_flash_v2", "ELEVENLABS_STABILITY": "0.5", "ELEVENLABS_SIMILARITY_BOOST": "0.75", "ELEVENLABS_STYLE": "0.1", "ELEVENLABS_OUTPUT_DIR": "output" } } } }

개발 설치

  1. 이 저장소를 복제하세요
  2. 종속성 설치:
    uv venv
  3. .env.example``.env 로 복사하고 ElevenLabs 자격 증명을 입력하세요.
{ "mcpServers": { "elevenlabs": { "command": "uv", "args": [ "--directory", "path/to/elevenlabs-mcp-server", "run", "elevenlabs-mcp-server" ], "env": { "ELEVENLABS_API_KEY": "your-api-key", "ELEVENLABS_VOICE_ID": "your-voice-id", "ELEVENLABS_MODEL_ID": "eleven_flash_v2", "ELEVENLABS_STABILITY": "0.5", "ELEVENLABS_SIMILARITY_BOOST": "0.75", "ELEVENLABS_STYLE": "0.1", "ELEVENLABS_OUTPUT_DIR": "output" } } } }

샘플 SvelteKit MCP 클라이언트 사용

  1. 웹 UI 디렉토리로 이동합니다.
    cd clients/web-ui
  2. 종속성 설치:
    pnpm install
  3. .env.example``.env 로 복사하고 필요에 따라 구성합니다.
  4. 웹 UI를 실행합니다.
    pnpm dev
  5. 브라우저에서 http://localhost:5174를 엽니다.

사용 가능한 도구

  • generate_audio_simple : 기본 음성 설정을 사용하여 일반 텍스트에서 오디오를 생성합니다.
  • generate_audio_script : 여러 음성과 배우가 포함된 구조화된 스크립트에서 오디오를 생성합니다.
  • delete_job : ID로 작업을 삭제합니다.
  • get_audio_file : ID로 오디오 파일을 가져옵니다.
  • list_voices : 사용 가능한 모든 음성을 나열합니다.
  • get_voiceover_history : 음성 더빙 작업 기록을 가져옵니다. 특정 작업의 작업 ID를 지정할 수도 있습니다.

사용 가능한 리소스

  • voiceover://history/{job_id} : ID로 오디오 파일을 가져옵니다.
  • voiceover://voices : 사용 가능한 모든 음성을 나열합니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

ID: leukzvus7o