SuperClonica text to speech

SuperClonica MCP サーバー

Claude やその他の MCP クライアント向けのテキスト読み上げ機能です。お使いのコンピューター上で動作し、初回実行後はオフラインで使用でき、回数制限もなく、31 言語に対応しています。クラウドサーバー https://superclonica.com/mcp のローカル版で、ツール名は同じです。音声は SuperClonica のカタログから選べます。

Python 3.10 以降を搭載した Windows、macOS、Linux で動作します。中国語には対応していません。

セットアップ

uvx コマンドを提供する uv が必要です。初回起動時にエンジンがインストールされるため、1～2 分ほどかかります。初回の speak 実行時に、音声モデル（約 400 MB）が一度だけダウンロードされます。

Claude Desktop。 claude_desktop_config.json に次の設定を追加し、アプリを再起動します。

{
  "mcpServers": {
    "superclonica": {
      "command": "uvx",
      "args": ["superclonica-mcp"],
      "env": { "SUPERCLONICA_API_KEY": "sc_..." }
    }
  }
}

アプリが uvx を見つけられない場合は、command にその絶対パスを指定してください。Windows では where uvx、macOS と Linux では which uvx を実行するとパスが表示されます。

Claude Code:

claude mcp add superclonica -e SUPERCLONICA_API_KEY=sc_... -- uvx superclonica-mcp

Cursor（~/.cursor/mcp.json）には、Claude Desktop と同じ JSON を指定します。VS Code（.vscode/mcp.json）には、"type": "stdio" を追加したうえで、同じエントリーを "servers" の下に指定します。

uvx を使わない場合も、次の方法で同じサーバーを起動できます。pipx run superclonica-mcp、または pip install superclonica-mcp の後に python -m superclonica_mcp を実行します。

API キーは任意です。標準音声と無料のカタログ音声には必要ありません。購入した音声や自分の音声をインストールする場合は必要です。キーの作成は無料です。

ツール

ツール	機能
list_voices(query?, limit?)	このコンピューター上の音声と、オンライン時はカタログの音声を表示します。それぞれについて、インストール済みか、自分の音声か、無料か、購入が必要かを、そのページとあわせて確認できます。
speak(text, voice, language, format?, output_path?, include_audio?)	このコンピューター上でテキストを音声化し、mp3、wav、または ogg 形式で保存します。ファイルのパスと長さを返し、指定された場合は音声自体も返します。1 回の呼び出しで最大 20000 文字まで対応します。既存のファイルが上書きされることはありません。
install_voice(voice)	使用可能な音声をこのコンピューターにダウンロードします。すでに持っているバージョンは再ダウンロードされません。
buy_voice(voice)	音声のページへのリンクを返します。**購入処理は行いません。**ブラウザーで購入した後、アシスタントにインストールを指示してください。
play(path)	システムプレーヤーで mp3、wav、または ogg ファイルを再生します。
get_usage()	モデルが読み込まれているか、どのデバイスで動作しているか、また使用されているフォルダーを表示します。ローカルエンジンに制限はありません。

voice には、list_voices の ID、標準名（F1～F5、M1～M5）、または正確な名前を指定します。名前が複数の音声に一致する場合は、候補が表示されるため、推測で選ばれることはありません。

自分の音声ファイルを使うには、その JSON を voices フォルダーに入れてください。ファイル名が音声名になります。

音声の購入

1. たとえば「落ち着いたナレーターを探して」と頼みます。アシスタントが list_voices を呼び出します。
2. 購入が必要な場合、アシスタントが buy_voice を呼び出し、購入画面を開くリンクを提示します。
3. ブラウザーで購入を確定します。購入できるのは、自分でクリックした場合だけです。
4. 「インストールして」と伝えます。その後は、音声をオフラインで使用できます。

設定

すべて任意の環境変数です。

変数	意味	デフォルト
SUPERCLONICA_API_KEY	購入した音声や自分の音声をインストールするためのキー	なし
SUPERCLONICA_VOICES_DIR	音声フォルダー	Windows %APPDATA%\SuperClonica\voices；macOS ~/Library/Application Support/SuperClonica/voices；Linux ~/.local/share/superclonica/voices
SUPERCLONICA_OUTPUT_DIR	音声ファイルの保存フォルダー	voices フォルダーと同じ場所の audio
SUPERCLONICA_DEVICE	cpu または gpu	GPU エンジンがインストールされている場合は GPU、それ以外は CPU

NVIDIA GPU で高速化

uvx superclonica-mcp では CPU エンジンがインストールされます。CPU エンジンと GPU エンジンは、同じ環境を共有できません。GPU エンジンを使用するには（Windows または Linux x86-64、Python 3.11 以降）、専用の環境を作成します。

uv venv superclonica-gpu --python 3.12
uv pip install --python superclonica-gpu superclonica-gpu-cuda
uv pip install --python superclonica-gpu --no-deps superclonica-mcp
uv pip install --python superclonica-gpu "mcp>=2.3,<3" "truststore>=0.10"

次に、その環境の Python をコマンドとして使い、引数に -m superclonica_mcp、env に SUPERCLONICA_DEVICE=gpu を指定します。

問題が発生した場合

• 「音声モデルの読み込み中です」： 初回実行時にモデルをダウンロードしており、バックグラウンドで処理が続いています。1 分ほど待ってから、もう一度お試しください。
• クライアントにツールが表示されない場合： サーバーのログを確認してください（Claude Desktop：設定 → 開発者）。サーバーはログを stderr にのみ出力します。
• 長文がタイムアウトする場合： CPU を使用している場合は、音声合成する長文を分割してください。

ライセンス

Apache-2.0。音声モデルは Supertonic 3 で、独自の OpenRAIL-M ライセンスに基づいています。エンジンが元の配布元からダウンロードします。