Mamertofabian Elevenlabs MCP Server

🚀 ElevenLabs MCP Server

An MCP (Model Context Protocol) server integrated with the ElevenLabs Text-to-Speech API. It includes a server component and an example web-based MCP client (using SvelteKit) for managing voice generation tasks.

✨ Features

• Generate audio from text using the ElevenLabs API.
• Support multiple voices and script sections.
• Store history using an SQLite database.
• The example SvelteKit MCP client provides:
  • Simple text-to-speech conversion.
  • Multi-section script management.
  • Voice history tracking and playback.
  • Audio file download.

📦 Installation

Using uvx (Recommended)

When using uvx, no special installation is required.

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

💻 Usage Examples

Using the 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

• Text-to-Speech: Convert text to speech.
• Voice Playback: Play the generated voice files.
• History: View previous voice generation records.
• Clear History: Clear the history.

Resources

• voiceover://history/{job_id}: Access the history of a specific task.
• voiceover://output/{filename}: Access the generated audio files.
• voiceover://settings: Configure voice generation parameters.

📄 License

This project is licensed under the MIT License.