Skip to main content
Glama
ElevenLabs MCP Server

ElevenLabs MCP Server

ElevenLabs MCP 서버

대장간 배지

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

특징

  • ElevenLabs API를 사용하여 텍스트에서 오디오 생성

  • 다양한 음성 및 스크립트 부분 지원

  • 영구적인 기록 저장을 위한 SQLite 데이터베이스

  • 샘플 SvelteKit MCP 클라이언트:

    • 간단한 텍스트-음성 변환

    • 다중 파트 스크립트 관리

    • 음성 기록 추적 및 재생

    • 오디오 파일 다운로드

Related MCP server: ElevenLabs MCP Server

설치

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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

Available Tools

6 tools
delete_jobB

Delete a voiceover job and its associated files

Inputs: job_id (required).

generate_audio_scriptB

Generate audio from a structured script with multiple voices and actors. Accepts either: 1. Plain text string 2. JSON string with format: { "script": [ { "text": "Text to speak", "voice_id": "optional-voice-id", "actor": "optional-actor-name" }, ... ] }

Inputs: script (required).

generate_audio_simpleC

Generate audio from plain text using default voice settings

Inputs: text (required), voice_id.

get_audio_fileC

Get the audio file content for a specific job

Inputs: job_id (required).

get_voiceover_historyB

Get voiceover job history. Optionally specify a job ID for a specific job.

Inputs: job_id.

list_voicesB

Get a list of all available ElevenLabs voices with metadata

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no ambiguity. delete_job removes jobs, generate_audio_script creates multi-voice audio from structured input, generate_audio_simple creates basic audio, get_audio_file retrieves audio content, get_voiceover_history accesses job history, and list_voices lists available voices. The two generation tools are clearly differentiated by complexity level.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern throughout: delete_job, generate_audio_script, generate_audio_simple, get_audio_file, get_voiceover_history, list_voices. The naming convention is perfectly uniform with clear action-object relationships and no mixing of styles.

    Tool Count5/5

    Six tools is an ideal number for this audio generation domain. It provides complete coverage of core workflows (generation, retrieval, management, discovery) without being overwhelming. Each tool earns its place with clear utility in the voiceover job lifecycle.

    Completeness5/5

    The toolset provides complete CRUD/lifecycle coverage for ElevenLabs voiceover operations: create (two generation tools), read (get_audio_file, get_voiceover_history, list_voices), delete (delete_job). There are no obvious gaps - agents can create audio, retrieve results, manage jobs, and discover available voices.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers