Voice Status Report MCP Server

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

このサーバーは、OpenAI のテキスト音声変換 API を使用して、音声によるステータス更新を提供する モデルコンテキストプロトコル (MCP) サーバーです。これにより、言語モデルは短い音声メッセージでユーザーと通信できます。具体的には、タスクの進捗状況を報告したり、コマンドの実行を確認したりすることが可能です。Cursor や Claude といったコードと共に使用する際に特に便利で、エージェントにタスクを割り当てて他の作業に移っても、エージェントの進捗状況やタスク完了後の通知を受け取ることができます。

この 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: 各音声メッセージの前にチャイム音を鳴らす機能を有効にします。デフォルトは無効です。
• --api-key: OpenAI API キーを指定します。デフォルトでは環境変数 OPENAI_API_KEY から取得します。
• --volume: 再生する音声の音量を設定します（0 から 1 の範囲）。デフォルトは 1.0 です。

サンプル

# デフォルト設定でサーバーを起動する
python3 -m voice_status_report_mcp_server

# 音量を下げてサーバーを起動する
python3 -m voice_status_report_mcp_server --volume 0.5

# カスタム API キーを設定する
python3 -m voice_status_report_mcp_server --api-key your_api_key_here

Claude for Desktop での使用方法

インストール

voice-status-report ディレクトリを Python パスに追加します。例えば、以下のように実行します。

export PYTHONPATH="${PYTHONPATH}:/path/to/voice-status-report"

設定

~/.config/claude/claude_desktop_config.json ファイルを編集または作成し、以下の内容を追加して音声レポートを有効にします。

{
  "mcpServers": {
    "voice-status-report": {
      "command": "python3",
      "args": [
        "-m",
        "voice_status_report_mcp_server"
      ],
      "env": {
        "OPENAI_API_KEY": "your_api_key_here"
      }
    }
  }
}

💻 使用例

基本的な使用法

タスクを割り当てた後に使用する例です。

from voice_status_report import summarize

summarize("正在处理你的请求...")

タスクが完了した後にユーザーに通知する例です。

from voice_status_report import summarize

summarize("任务已完成！请查看结果。")

📄 ライセンス

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