📢 Blabber-MCP 🗣️

OpenAIのText-to-Speech APIを使用して、LLMに声を与えるMCPサーバーです！ 🔊

✨ 機能

• テキスト読み上げ (Text-to-Speech): 入力テキストを高品質な音声に変換します。

• 音声選択: OpenAIのさまざまな音声（alloy、echo、fable、onyx、nova、shimmer）から選択可能です。

• モデル選択: 標準（tts-1）または高精細（tts-1-hd）モデルを使用できます。

• 形式オプション: オーディオ出力を mp3、opus、aac、または flac で取得できます。

• ファイル保存: 生成された音声をローカルファイルに保存します。

• オプションの再生: 設定可能なシステムコマンドを使用して、生成された音声を自動的に再生します。

• 設定可能なデフォルト: 設定を通じてデフォルトの音声を指定できます。

Related MCP server: NijiVoice-MCP

🔧 設定

このサーバーを使用するには、MCPクライアントの設定ファイル（例: mcp_settings.json）に設定を追加する必要があります。

1. OpenAI APIキーの取得: OpenAIからAPIキーを取得してください。

2. MCP設定への追加: 設定ファイルの mcpServers オブジェクトに以下のブロックを追加し、"YOUR_OPENAI_API_KEY" を実際のキーに置き換えてください。

{
  "mcpServers": {
    "blabber-mcp": {
      "command": "node",
      "args": ["/full/path/to/blabber-mcp/build/index.js"], (IMPORTANT: Use the full, absolute path to the built index.js file)
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY",
        "AUDIO_PLAYER_COMMAND": "xdg-open", (Optional: Command to play audio (e.g., "cvlc", "vlc", "mpv", "ffplay", "afplay", "xdg-open"; defaults to "cvlc")
        "DEFAULT_TTS_VOICE": "nova" (Optional: Set default voice (alloy, echo, fable, onyx, nova, shimmer); defaults to nova)
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

重要: args のパスが、blabber-mcp プロジェクトディレクトリ内の build/index.js ファイルの正しい場所を指していることを確認してください。フル絶対パスを使用してください。

🚀 使用方法

設定が完了し実行中であれば、MCPクライアント経由で text_to_speech ツールを使用できます。

ツール: text_to_speech サーバー: blabber-mcp（または設定で使用したキー）

引数:

• input (文字列、必須): 合成するテキスト。

• voice (文字列、オプション): 使用する音声（alloy、echo、fable、onyx、nova、shimmer）。設定で指定された DEFAULT_TTS_VOICE、または nova がデフォルトになります。

• model (文字列、オプション): モデル（tts-1、tts-1-hd）。デフォルトは tts-1 です。

• response_format (文字列、オプション): オーディオ形式（mp3、opus、aac、flac）。デフォルトは mp3 です。

• play (ブール値、オプション): 保存後に音声を自動再生するには true に設定します。デフォルトは false です。

ツール呼び出しの例（再生あり）:

<use_mcp_tool>
  <server_name>blabber-mcp</server_name>
  <tool_name>text_to_speech</tool_name>
  <arguments>
  {
    "input": "Hello from Blabber MCP!",
    "voice": "shimmer",
    "play": true
  }
  </arguments>
</use_mcp_tool>

出力:

このツールはオーディオファイルを blabber-mcp プロジェクトフォルダ内の output/ ディレクトリに保存し、以下のようなJSONレスポンスを返します：

{
  "message": "Audio saved successfully. Playback initiated using command: cvlc",
  "filePath": "path/to/speech_1743908694848.mp3", 
  "format": "mp3",
  "voiceUsed": "shimmer"
}

📜 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。

🕒 変更履歴

バージョン履歴の詳細は CHANGELOG.md ファイルを参照してください。