ElevenLabs MCP Server

ElevenLabs MCP Server

ElevenLabs のテキスト読み上げ API と連携する Model Context Protocol（MCP）サーバーです。音声生成タスクを管理するためのサーバーコンポーネントと、サンプルのウェブベース MCP クライアント（SvelteKit）を備えています。

機能

• ElevenLabs API を使用してテキストから音声を生成
• 複数の音声とスクリプトパートをサポート
• 履歴を永続的に保存する SQLite データベース
• サンプルの SvelteKit MCP クライアントで利用できる機能：
  • 簡単なテキスト読み上げ変換
  • 複数パートのスクリプト管理
  • 音声履歴の追跡と再生
  • 音声ファイルのダウンロード

インストール

Smithery 経由でインストール

Smithery 経由で、ElevenLabs MCP Server を Claude Desktop に自動でインストールするには：

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

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 License の下でライセンスされています。詳細については LICENSE ファイルをご覧ください。