ElevenLabs

公式

公式のElevenLabs MCPサーバー

GitHub
1.5k

Eleven Labs MCPで何ができますか？

  • テキストから音声を生成 — text_to_speech を使用して、任意のテキストを ElevenLabs の音声で読み上げ音声に変換します。
  • カスタム音声をデザイン — design_voice を使用して、特定の性格、アクセント、スタイルを持つ新しい合成音声を作成します。
  • 音声から声をクローン — サンプル録音をアップロードし、clone_voice でそれを模倣する声を作成します。
  • 音声をテキストに文字起こし — transcribe_speech を使用して、話者分離機能付きで音声録音を書き起こしテキストに変換します。
  • 音声変換を適用 — voice_conversion を使用して、ある音声録音を別の話者やキャラクターのように変換します。
  • 効果音を生成 — generate_sound_effects を使用して、天候や環境シーンなどのテキスト説明からオーディオサウンドスケープを生成します。

ドキュメント

export

Discord Community Twitter PyPI Tests

強力なテキスト読み上げおよび音声処理APIとの連携を可能にする、公式ElevenLabs Model Context Protocol (MCP) サーバーです。このサーバーにより、Claude Desktop、Cursor、Windsurf、OpenAI Agents などのMCPクライアントは、音声の生成、声のクローン作成、音声の文字起こしなどを行うことができます。

Claude Desktopでのクイックスタート

  1. ElevenLabsからAPIキーを取得します。毎月1万クレジットの無料枠があります。
  2. uv（Pythonパッケージマネージャー）をインストールし、curl -LsSf https://astral.sh/uv/install.sh | shでインストールするか、その他のインストール方法についてはuv リポジトリを参照してください。
  3. Claude > 設定 > 開発者 > 設定を編集 > claude_desktop_config.json に移動し、以下を含めます。
{
  "mcpServers": {
    "ElevenLabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp"],
      "env": {
        "ELEVENLABS_API_KEY": "<insert-your-api-key-here>"
      }
    }
  }
}

Windowsを使用している場合、MCPサーバーを使用するにはClaude Desktopで「開発者モード」を有効にする必要があります。左上のハンバーガーメニューで「ヘルプ」をクリックし、「開発者モードを有効にする」を選択します。

その他のMCPクライアント

CursorやWindsurfなどの他のクライアントの場合は、以下を実行します。

  1. pip install elevenlabs-mcp
  2. python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print で設定を取得します。MCPクライアントが指定する適切な設定ディレクトリに貼り付けてください。

以上です。これでMCPクライアントは以下のツールを通じてElevenLabsとやり取りできるようになります。

使用例

⚠️ 警告: これらのツールを使用するにはElevenLabsのクレジットが必要です。

Claudeに次のように尋ねてみてください。

  • 「フィルムノワールの探偵のように話し、クラシック映画に関する質問に答えられるAIエージェントを作成して」
  • 「賢く古いドラゴンキャラクターの声のバリエーションを3つ生成して。お気に入りの声を選んでボイスライブラリに追加するから」
  • 「この自分の声の録音を中世の騎士のように変換して」
  • 「密集したジャングルでの雷雨のサウンドスケープを作成し、天候に反応する動物たちの音を加えて」
  • 「この音声をテキストに変換し、異なる話者を識別してから、各人に固有の声を使用して音声に戻して」

オプション機能

ファイル出力設定

claude_desktop_config.json で以下の環境変数を使用して、MCPサーバーがファイル出力を処理する方法を設定できます。

  • ELEVENLABS_MCP_BASE_PATH: 相対パスでのファイル操作のベースパスを指定します（デフォルト: ~/Desktop）
  • ELEVENLABS_MCP_OUTPUT_MODE: 生成されたファイルの返却方法を制御します（デフォルト: files）

出力モード

ELEVENLABS_MCP_OUTPUT_MODE 環境変数は3つのモードをサポートします。

  1. files（デフォルト）: ファイルをディスクに保存し、ファイルパスを返します

    "env": {
  "ELEVENLABS_API_KEY": "your-api-key",
  "ELEVENLABS_MCP_OUTPUT_MODE": "files"
}

  2. resources: ファイルをMCPリソースとして返します。バイナリデータはbase64エンコードされ、テキストはUTF-8テキストとして返されます

    "env": {
  "ELEVENLABS_API_KEY": "your-api-key",
  "ELEVENLABS_MCP_OUTPUT_MODE": "resources"
}

  3. both: ファイルをディスクに保存し、かつMCPリソースとして返します

    "env": {
  "ELEVENLABS_API_KEY": "your-api-key",
  "ELEVENLABS_MCP_OUTPUT_MODE": "both"
}

リソースモードの利点:

  • ファイルはbase64エンコードされたデータとしてMCPレスポンスで直接返されます
  • ディスクI/Oが不要 - コンテナ化環境やサーバーレス環境に役立ちます
  • MCPクライアントはファイルシステムへのアクセスなしで即座にファイルコンテンツにアクセスできます
  • both モードでは、後で elevenlabs://filename URIパターンを使用してリソースを取得できます

ユースケース:

  • files: 従来のファイルベースのワークフロー、ローカル開発
  • resources: クラウド環境、ファイルシステムアクセスのないMCPクライアント
  • both: 最大限の柔軟性、キャッシング、リソース共有シナリオ

データレジデンシーキー

ELEVENLABS_API_RESIDENCY 環境変数でデータレジデンシーリージョンを指定できます。デフォルトは "us" です。

注: データレジデンシーはエンタープライズ専用の機能です。詳細はドキュメントを参照してください。

貢献

貢献またはソースから実行する場合:

  1. リポジトリをクローンします:
git clone https://github.com/elevenlabs/elevenlabs-mcp
cd elevenlabs-mcp
  1. 仮想環境を作成し、uvを使用して依存関係をインストールします:
uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"
  1. .env.example を .env にコピーし、ElevenLabs APIキーを追加します:
cp .env.example .env
# Edit .env and add your API key
  1. テストを実行して、すべてが正常に動作することを確認します:
./scripts/test.sh
# Or with options
./scripts/test.sh --verbose --fail-fast

  1. Claude Desktopにサーバーをインストールします: mcp install elevenlabs_mcp/server.py

  2. MCP Inspectorでローカルにデバッグおよびテストします: mcp dev elevenlabs_mcp/server.py

トラブルシューティング

Claude Desktopでの実行時のログは以下にあります。

  • Windows: %APPDATA%\Claude\logs\mcp-server-elevenlabs.log
  • macOS: ~/Library/Logs/Claude/mcp-server-elevenlabs.log

特定のツール使用時のタイムアウト

ボイスデザインや音声分離など、特定のElevenLabs API操作は解決に時間がかかる場合があります。開発モードでMCPインスペクターを使用している場合、ツールが意図したタスクを完了してもタイムアウトエラーが発生することがあります。

これはClaudeのようなクライアントを使用している場合は発生しないはずです。

MCP ElevenLabs: spawn uvx ENOENT

「MCP ElevenLabs: spawn uvx ENOENT」エラーが発生した場合、ターミナルで次のコマンドを実行して絶対パスを確認します。

which uvx

絶対パス（例: /usr/local/bin/uvx）を取得したら、そのパスを使用するように設定を更新します（例: "command": "/usr/local/bin/uvx"）。これにより、正しい実行可能ファイルが参照されるようになります。