Mamertofabian Elevenlabs MCP Server

🚀 ElevenLabs MCP サーバー

ElevenLabs のテキスト読み上げ API を組み合わせたモデルコンテキストプロトコル (MCP) サーバーです。サーバーコンポーネントと、SvelteKit を使用したサンプルの Web ベースの MCP クライアントが含まれており、音声生成タスクを管理することができます。

✨ 主な機能

• ElevenLabs API を使用してテキストから音声を生成する
• 複数の声とスクリプト部分をサポートする
• SQLite データベースを使用して履歴を保存する
• サンプルの SvelteKit MCP クライアントでは以下が提供されます：
  • シンプルなテキスト読み上げ変換
  • 複数部分のスクリプト管理
  • 音声履歴の追跡と再生
  • 音声ファイルのダウンロード

📦 インストール

uvx を使用する場合（推奨）

uvx を使用する場合は、特別なインストールは必要ありません。

MCP 設定ファイル（例：Claude Desktop の cline_mcp_settings.json）に以下の設定を追加します。

{
  "mcpServers": {
    "elevenlabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp-server"],
      "env": {
        "ELEVENLABS_API_KEY": "あなたの API キー",
        "ELEVENLABS_VOICE_ID": "あなたの音声 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": "あなたの API キー",
        "ELEVENLABS_VOICE_ID": "あなたの音声 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. Web UI ディレクトリに移動します。

   cd clients/web-ui
   

2. 依存関係をインストールします。

   pnpm install
   

3. .env.example を .env にコピーし、必要に応じて設定します。
4. Web UI を起動します。

   pnpm dev
   

5. ブラウザで http://localhost:5174 を開きます。

利用可能なツール

• テキスト読み上げ：テキストを音声に変換します。
• 音声再生：生成された音声ファイルを再生します。
• 履歴：以前の音声生成履歴を表示します。
• 履歴のクリア：履歴を削除します。

リソース

• voiceover://history/{job_id}：特定のタスクの履歴にアクセスします。
• voiceover://output/{filename}：生成された音声ファイルにアクセスします。
• voiceover://settings：音声生成パラメータを設定します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。