ElevenLabs MCP Server

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で「開発者モード」を有効にする必要があります。左上のハンバーガーメニューで「ヘルプ」をクリックし、「開発者モードを有効にする」を選択してください。

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 クレジットが必要です。

クロードに聞いてみてください:

• 「フィルム・ノワールの探偵のように話し、古典映画に関する質問に答えられるAIエージェントを作成する」

• 「賢い古代ドラゴンのキャラクターの音声バリエーションを 3 つ生成し、その中からお気に入りの音声を選択して音声ライブラリに追加します。」

• 「私の声の録音を中世の騎士のように変換してください」

• 「動物たちが天候に反応する、密林での雷雨のサウンドスケープを作成する」

• 「このスピーチをテキストに変換し、異なる話者を識別し、各人の固有の声を使用して元の音声に変換します」

オプション機能

claude_desktop_config.jsonにELEVENLABS_MCP_BASE_PATH環境変数を追加して、MCP サーバーが検索する基本パスと、相対パスで指定された出力ファイルを指定できます。

貢献

貢献したりソースから実行したりしたい場合:

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: スポーンUVX ENOENT

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

which uvx

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