Elevenlabs MCP

🚀 クイックスタート（Claude Desktop）

Claude Desktopをすぐに使い始めるためのガイドです。以下の手順に従ってセットアップしましょう。

手順

1. ElevenLabs からAPIキーを取得します。無料プランでは月に10,000クレジットが提供されます。
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": "<ここにあなたのAPIキーを挿入してください>"
      }
    }
  }
}

Windowsを使用している場合は、Claude Desktopで「開発者モード」を有効にしてMCPサーバーを使用できるようにしてください。メニューバーの左側にあるハンバーガーアイコンをクリックし、「ヘルプ」>「開発者モードを有効にする」を選択します。

✨ その他のMCPクライアント

CursorやWindsurfなどの他のクライアントでは、以下の手順を実行してください。

1. pip install elevenlabs-mcp を実行します。
2. python -m elevenlabs_mcp --api-key={{あなたのAPIキーをここに入力}} --print を実行して設定を取得し、MCPクライアントの指定された設定ディレクトリに貼り付けます。

これで、あなたのMCPクライアントはElevenLabsを介して使用できるようになります。

💻 使用例

ログファイルの場所

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

🔧 貢献方法

1. .env.example を .env にコピーし、ElevenLabsのAPIキーを追加します。

cp .env.example .env
# .envファイルを編集し、あなたのAPIキーを追加します

2. すべてが正常に動作することを確認するためにテストを実行します。

./scripts/test.sh
# またはオプションを使用して
./scripts/test.sh --verbose --fail-fast

3. Claude Desktopでサーバーをインストールします。mcp install elevenlabs_mcp/server.py

4. MCPチェッカーを使用してローカルでデバッグとテストを行います。mcp dev elevenlabs_mcp/server.py

📚 トラブルシューティング

• Windows：ログは %APPDATA%\Claude\logs\mcp-server-elevenlabs.log にあります。
• macOS：ログは ~/Library/Logs/Claude/mcp-server-elevenlabs.log にあります。