elevenlabs-mcp

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

1. ElevenLabs からAPIキーを取得します。月間1万クレジットの無料枠があります。

2. uv（Pythonパッケージマネージャー）をインストールします。curl -LsSf https://astral.sh/uv/install.sh | sh を実行するか、uv の リポジトリ でその他のインストール方法を確認してください。

3. Claude > Settings > Developer > Edit Config > claude_desktop_config.json に移動し、以下を追記します：

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp"],
      "env": {
        "ELEVENLABS_API_KEY": "<insert-your-api-key-here>"
      }
    }
  }
}

Windowsを使用している場合、MCPサーバーを使用するにはClaude Desktopで「Developer Mode（開発者モード）」を有効にする必要があります。左上のハンバーガーメニューから「Help」をクリックし、「Enable Developer Mode」を選択してください。

Related MCP server: ElevenLabs MCP Server

その他の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

2. 仮想環境を作成し、uvを使用して 依存関係をインストールします：

uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"

3. .env.example を .env にコピーし、ElevenLabs APIキーを追加します：

cp .env.example .env
# Edit .env and add your API key

4. テストを実行してすべてが正常に動作することを確認します：

./scripts/test.sh
# Or with options
./scripts/test.sh --verbose --fail-fast

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

6. 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"）。これにより、正しい実行ファイルが参照されるようになります。