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

특징

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

설치

Smithery를 통해 설치 중

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

UVX 사용 (권장)

uvx를 사용할 때는 별도의 설치가 필요하지 않습니다.

다음 구성을 MCP 설정 파일에 추가하세요(예: Claude Desktop의 cline_mcp_settings.json):

개발 설치

1. 이 저장소를 복제합니다

2. 의존성 설치:

3. .env.example를 .env로 복사하고 ElevenLabs 자격 증명을 입력하세요

샘플 SvelteKit MCP 클라이언트를 사용하여

1. 웹 UI 디렉터리로 이동하기:

2. 의존성 설치:

3. .env.example를 .env로 복사하고 필요에 따라 구성

ElevenLabs MCP Server

A Model Context Protocol (MCP) server that integrates with ElevenLabs text-to-speech API, featuring both a server component and a sample web-based MCP Client (SvelteKit) for managing voice generation tasks.

Features

• Generate audio from text using ElevenLabs API
• Support for multiple voices and script parts
• SQLite database for persistent history storage
• Sample SvelteKit MCP Client for:
  • Simple text-to-speech conversion
  • Multi-part script management
  • Voice history tracking and playback
  • Audio file downloads

Installation

Installing via Smithery

To install ElevenLabs MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install elevenlabs-mcp-server --client claude

Using uvx (recommended)

When using uvx, no specific installation is needed.

Add the following configuration to your MCP settings file (e.g., cline_mcp_settings.json for Claude Desktop):

{
  "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"
      }
    }
  }
}

Development Installation

1. Clone this repository
2. Install dependencies:

   uv venv
   

3. Copy .env.example to .env and fill in your ElevenLabs credentials

{
  "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"
      }
    }
  }
}

Using the Sample SvelteKit MCP Client

1. Navigate to the web UI directory:

   cd clients/web-ui
   

2. Install dependencies:

   pnpm install
   

3. Copy .env.example to .env and configure as needed
4. Run the web UI:

   pnpm dev
   

5. Open http://localhost:5174 in your browser

Available Tools

• generate_audio_simple: Generate audio from plain text using default voice settings