TextToSpeech-MCP Server

TextToSpeech-MCP Server

macOS Say および Kokoro TTS エンジンを使用した、高品質でプライバシーを重視する音声合成を提供するローカルのテキスト読み上げ MCP サーバーです。

特長

• ローカル処理：すべての音声合成はローカルで実行され、外部サービスにデータが送信されません
• 複数のエンジン：
  • macOS Say（高速、標準搭載、23 種類の音声、複数の言語）
  • Kokoro TTS（高品質なニューラル音声合成、21 種類の音声、8 言語）
• MCP 統合：Claude Desktop やその他の MCP 対応クライアントで動作します
• 多言語対応：英語、スペイン語、フランス語、日本語、中国語など、43 言語に対応しています

クイックスタート

1. 依存関係をインストールする

npm install

2. プロジェクトをビルドする

npm run build

3. サーバーをテストする

npm start

4. Claude Desktop を設定する

この設定を Claude Desktop の設定に追加してください。

{
  "mcpServers": {
    "local-tts": {
      "command": "node",
      "args": ["./dist/server.js"],
      "cwd": "/path/to/your/TextToSpeech-MCP"
    }
  }
}

利用可能なツール

synthesize_text

カスタマイズ可能なオプションを指定して、テキストを音声に変換します。

パラメーター：

• text（必須）：変換するテキスト（最大 50,000 文字）
• voice（任意）：音声名（例：「Alex」、「Samantha」、「Daniel」）
• engine（任意）：「macos」、「kokoro」、または「auto」（デフォルト：「auto」）
• outputFormat（任意）：「aiff」、「wav」、「mp3」、「m4a」（デフォルト：「aiff」）
• speed（任意）：速度倍率 0.1～3.0（デフォルト：1.0）
• quality（任意）：「fast」、「balanced」、「high」（デフォルト：「balanced」）

list_voices

フィルターオプションを指定して、利用可能な音声を一覧表示します。

パラメーター：

• engine（任意）：「macos」、「kokoro」、「all」（デフォルト：「all」）
• language（任意）：言語フィルター（例：「en-us」、「es」、「fr」）
• gender（任意）：「male」、「female」、「neutral」

health_check

エンジンの利用可否とシステムの状態を確認します。

play_audio

操作オプションを指定して、生成された音声ファイルを再生します。

パラメーター：

• audioPath（任意）：音声ファイルのパス（デフォルトでは最新のファイル）
• action（任意）：「play」、「pause」、「stop」、「resume」（デフォルト：「play」）

使用例

基本的な音声合成

Use the synthesize_text tool to say "Hello, world!" using the default voice.

音声の選択

List all English female voices, then use one to synthesize a greeting.

多言語

Synthesize "Bonjour le monde" using a French voice.

開発

利用可能なスクリプト

• npm run build - TypeScript をビルドします
• npm run dev - ウォッチモードでビルドします
• npm start - サーバーを起動します
• npm test - テストを実行します（近日公開）
• npm run lint - ESLint を実行します
• npm run format - Prettier でコードをフォーマットします

環境変数

• TTS_OUTPUT_DIR - 音声の出力ディレクトリ（デフォルト：./output）
• TTS_TEMP_DIR - 一時ファイルのディレクトリ（デフォルト：./temp）
• TTS_ENGINE - デフォルトのエンジン：「macos」、「kokoro」、「auto」（デフォルト：「auto」）
• TTS_QUALITY - デフォルトの品質：「fast」、「balanced」、「high」（デフォルト：「balanced」）

ステータス

✅ フェーズ 1 完了：23 種類の音声を備えた macOS Say エンジン ✅ フェーズ 2 完了：21 種類の音声に対応した Kokoro TTS の統合 📋 フェーズ 3 予定：音声の一括再生と高度な機能

MCP Inspector でテストする

npx @modelcontextprotocol/inspector node dist/server.js

次に、http://localhost:5173 を開いて、サーバーを対話形式でテストしてください。

要件

• macOS（macOS Say エンジン用）
• Node.js 18+
• TypeScript

ライセンス

MIT