Voice Status Report MCP Server

音声ステータスレポート MCP サーバー

Model Context Protocol（MCP）サーバーです。OpenAIのテキスト読み上げ APIを使って、音声でステータスを通知します。これにより、言語モデルは短い音声メッセージでユーザーに連絡し、タスクの進捗を報告したり、コマンドの実行を確認したりできます。CursorやClaude codeを使う場合に特に便利です。エージェントにタスクを任せて別の作業を続けながら、エージェントの進捗や、タスクが完了して対応が必要になったタイミングについて、ステータスレポートを受け取れます。

このMCPサーバーは、必要な機能をすべて含むことを目指しています。summarize ツールの説明（ほとんどのMCPクライアントによってシステムメッセージの先頭に追加されます）では、タスクの進捗を報告するためにこのツールを使うようモデルに指示します。

利用可能なツール

サーバーは次のツールを公開します。

• summarize(text: str)：指定されたテキストをOpenAIのTTS APIで音声に変換し、ユーザーに再生します。コードの変更やコマンドの実行後に、ステータスの更新や確認を伝えるのに便利です。

使用方法

このサーバーを使用するには、OpenAI APIキーが必要です。

Claude for Desktop

claude_desktop_config.json（macOSでは~/Library/Application\ Support/Claude/claude_desktop_config.json、Windowsでは%APPDATA%/Claude/claude_desktop_config.jsonにあります）を更新し、次の内容を追加してください。

{
  "mcpServers": {
    "voice-status-report": {
      "command": "uvx",
      "args": [
        "voice-status-report-mcp-server"
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY"
      }
    }
  }
}

コマンドラインオプション

サーバーは次のコマンドラインオプションを受け付けます。

• --ding：各音声メッセージの前に再生するチャイム音を有効にします。デフォルトでは無効です。
• --voice [VOICE]：音声生成に使用する声を選択します。利用可能なオプション：alloy、ash、coral（デフォルト）、echo、fable、onyx、nova、sage、shimmer。
• --speed SPEED：読み上げ速度を設定します（0.5～4.0。値が大きいほど速くなります）。デフォルトは4.0です。
• --instructions TEXT：TTSモデルにカスタムの音声指示を指定します。デフォルトでは、落ち着いた親しみやすい声のプリセット指示が使用されます。

例

# Run with ding sound enabled and a different voice
voice-status-report-mcp-server --ding --voice nova

# Run with a slower speech speed
voice-status-report-mcp-server --speed 2.0

# Run with custom voice instructions
voice-status-report-mcp-server --instructions "Voice should be confident and authoritative"

Claude for Desktop の設定例

{
  "mcpServers": {
    "voice-status-calm": {
      "command": "uvx",
      "args": [
        "voice-status-report-mcp-server",
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY"
      }
    },
  }
}

デフォルト以外の引数を使用する場合は、次の設定を使用できます。

{
  "mcpServers": {
    "voice-status-report-mcp-server": {
      "command": "uvx",
      "args": [
        "voice-status-report-mcp-server",
        "--ding",
        "--voice", "nova",
        "--speed", "3.0",
        "--instructions", "Voice should be confident and authoritative"
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY"
      }
    }
  }
}

使用例

接続すると、Claudeはこのツールを使って、次のような音声フィードバックを提供できます。

• 「ユーザー認証を処理する新しい関数を追加しました」
• 「ログインフォームのバグを修正しました」
• 「APIクライアント用の新しいファイルを作成しました」
• 「OpenAI TTSのドキュメントへのリンクを追加しました」

ライセンス

このプロジェクトはMITライセンスのもとで公開されています。詳細はLICENSEファイルをご覧ください。