Elevenlabs MCP Server

🚀 ElevenLabs MCP サーバ

このサーバは、ElevenLabs のテキスト読み上げ API を統合したモデルコンテキストプロトコル (MCP) サーバです。サーバコンポーネントと、SvelteKit ベースの MCP クライアントのサンプルが含まれており、音声生成タスクの管理に役立ちます。

✨ 主な機能

• ElevenLabs API を使用してテキストから音声を生成します。
• 複数の音声とスクリプト部分をサポートします。
• SQLite データベースを使用して履歴を保存します。
• サンプルの SvelteKit MCP クライアントの機能：
  • シンプルなテキスト読み上げ変換
  • 複数部分のスクリプト管理
  • 音声履歴の追跡と再生
  • 音声ファイルのダウンロード

📦 インストール

Smithery を通じたインストール

Smithery を自動的に使用して、Claude Desktop 上に ElevenLabs MCP Server をインストールします。

npx -y @smithery/cli install elevenlabs-mcp-server --client claude

uvx の使用（推奨）

uvx を使用する場合は、特別なインストールは必要ありません。

MCP 設定ファイル（Claude Desktop の場合は cline_mcp_settings.json など）に以下の設定を追加します。

{
  "mcpServers": {
    "elevenlabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp-server"],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key", // あなたの API キーに置き換えてください
        "ELEVENLABS_VOICE_ID": "your-voice-id", // 選択した音声 ID に置き換えてください
        "ELEVENLABS_MODEL_ID": "eleven_flash_v2",
        "ELEVENLABS_STABILITY": "0.5",
        "ELEVENLABS_SIMILARITY_BOOST": "0.75",
        "ELEVENLABS_STYLE": "0.1",
        "ELEVENLABS_OUTPUT_DIR": "output"
      }
    }
  }
}

開発用インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   uv venv
   

3. .env.example を .env にコピーし、ElevenLabs の認証情報を入力します。

{
  "mcpServers": {
    "elevenlabs": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/elevenlabs-mcp-server",
        "run",
        "elevenlabs-mcp-server"
      ],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key",
        "ELEVENLABS_VOICE_ID": "your-voice-id",
        "ELEVENLABS_MODEL_ID": "eleven_flash_v2",
        "ELEVENLABS_STABILITY": "0.5",
        "ELEVENLABS_SIMILARITY_BOOST": "0.75",
        "ELEVENLABS_STYLE": "0.1",
        "ELEVENLABS_OUTPUT_DIR": "output"
      }
    }
  }
}

💻 使用例

SvelteKit ベースの MCP クライアントを使用するには、以下の手順を実行します。

1. ディレクトリに移動します。

   cd your-project-directory
   

2. 依存関係をインストールします。

   npm install
   

3. 環境変数を設定し、サービスを起動します。

ツール

• text-to-speech：テキストを音声に変換します。
• script-manager：複数のスクリプト部分を管理します。

リソース

• URL パターン：
  • http://localhost:5000/text-to-speech
  • http://localhost:5000/script-manager

📄 ライセンス

MIT License