ElevenLabs

@mindstone/mcp-server-elevenlabs

Model Context Protocol ホスト向けの ElevenLabs MCP サーバーです。標準化された MCP インターフェースを通じて ElevenLabs API を使用し、音声、音楽、効果音の生成、ボイスの閲覧、音声の文字起こしができます。

ステータス

• バージョン： 0.5.2 · npm
• 認証： API キー（ELEVENLABS_API_KEY）
• ツール： 32（アカウント、使用状況、ボイス、音声、音楽、文字起こし、ボイス変換、分離、アラインメント、クローン作成、対話、ボイスデザイン、吹き替え、履歴、発音辞書）
• 対象： クラウド API
• 機械可読： STATUS.json

必要条件

• Node.js 20+
• npm

ワンクリックインストール

ボタンをクリックすると、ホストから ELEVENLABS_API_KEY の入力を求められます。

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-elevenlabs"
      ],
      "env": {
        "ELEVENLABS_API_KEY": ""
      }
    }
  }
}

クイックスタート

インストールとビルド

cd <path-to-repo>/connectors/elevenlabs
npm install
npm run build

npx（公開後）

npx -y @mindstone/mcp-server-elevenlabs

ローカル

node dist/index.js

設定

環境変数

• ELEVENLABS_API_KEY — ElevenLabs API キー（sk_ で始まります）
• MCP_HOST_BRIDGE_STATE — 認証情報の管理に使用するホストブリッジの状態ファイルへの任意のパス
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE との後方互換性を保つ別名

ホスト設定の例

Claude Desktop / Cursor

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-elevenlabs"],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key"
      }
    }
  }
}

ローカル開発（npm での公開は不要）

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/elevenlabs/dist/index.js"],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key"
      }
    }
  }
}

ツール（32）

設定

• configure_elevenlabs_api_key — ElevenLabs API キーを保存します

アカウントと検索（無料）

• check_subscription — サブスクリプションのティアと文字クレジットの使用状況を確認します
• get_usage_stats — 製品／モデル／ボイスごとにグループ化した期間別クレジット使用状況（ワークスペース分析 API）
• list_models — 言語と機能を含む TTS モデルの一覧を取得します

ボイス

• list_voices — アカウントのボイスを検索、閲覧します
• get_voice — voice_id を指定して、1 つのボイスの詳細を取得します
• search_shared_voices — 公開共有ボイスライブラリを検索します（アクセントなどで絞り込めます）
• clone_voice — ローカルの音声サンプルからインスタントボイスクローンを作成します（destructiveHint）
• delete_voice — ボイスを完全に削除します（destructiveHint）
• design_voice — テキストの説明からボイスデザインのプレビューを生成します（時間がかかります。プレビューはワークスペースに保存されます）
• create_voice_from_preview — デザインプレビューを永続的なボイスとして保存します（destructiveHint）

音声生成と変換

• generate_speech — テキスト読み上げを使用してテキストから音声を生成します（seed と pronunciation_dictionary_locators に対応）
• generate_speech_with_timestamps — 文字単位のタイミング情報付きで音声を生成します。.srt 字幕ファイルとアラインメント JSON も書き込みます
• generate_sound_effect — テキストの説明から効果音を生成します
• speech_to_speech — 元の音声を別の声に変換します
• text_to_dialogue — 台本から複数の声による会話を生成します（1行につき1つの声）

履歴（無料）

• list_history — 以前に生成した音声項目を一覧表示します（先週のナレーションを探す場合など）
• get_history_item_audio — history_item_id を指定して、過去に生成した音声を再ダウンロードします

発音辞書

• list_pronunciation_dictionaries — 発音辞書（ブランド名、専門用語）を一覧表示します（無料）
• get_pronunciation_dictionary — 1つの辞書のメタデータと現在のルールを取得します（無料）
• add_pronunciation_dictionary — エイリアス／IPA ルールから辞書を作成します（destructiveHint）
• archive_pronunciation_dictionary — 辞書をアーカイブし、適用されないようにします（destructiveHint。ダッシュボードから元に戻せます）

音声処理

• isolate_audio — 音声ファイルから背景ノイズを除去します（音声の長さは約4.6秒以上である必要があります。これより短いクリップは上流で失敗します）
• forced_alignment — 単語ごとのタイムスタンプを付けて、文字起こしテキストを音声にアラインメントします

吹き替え（v1 API — 非同期で送信 → ポーリング → ダウンロード）

• create_dubbing — 吹き替えジョブを送信します（サンドボックス経由のローカル file、または ElevenLabs 側で取得する source_url）
• get_dubbing — ステータスが dubbed、failed、または cancelled になるまでジョブをポーリングします
• download_dubbed_audio — 吹き替え音声をダウンロードします（Content-Type を判定）
• delete_dubbing — 吹き替えジョブを完全に削除します（destructiveHint）

音楽

• generate_music — テキストプロンプトから音楽を生成します
• create_music_plan — 音楽生成の作曲プランを作成します（無料）
• generate_music_from_plan — 作曲プランから音楽を生成します

文字起こし

• transcribe_audio — 音声ファイルの音声をテキストに文字起こしします。オプションで話者ダイアライゼーション（diarize、num_speakers、diarization_threshold）や単語単位のタイムスタンプ（include_word_timestamps）にも対応しています。モデルは scribe_v1 と scribe_v2 です

アップロードツールで使用するローカルファイルのパスは、MCP_WORKSPACE_PATH 内にある必要があります（未設定の場合は os.tmpdir() を使用します）。src/tools/file-input.ts を参照してください。生成またはダウンロードされたファイル（音声、字幕、履歴／吹き替えのダウンロード、音声設計のプレビュー）は、排他的な作成を用いて同じ正規ワークスペースルートに書き込まれます。既存のファイルが上書きされることはありません。src/tools/path-safety.ts を参照してください。

ライセンス

FSL-1.1-MIT — Functional Source License, Version 1.1。将来的に MIT ライセンスとなります。このソフトウェアは2030-04-08に MIT ライセンスへ移行します。