MCP Voice Hooks

🚀 Claude Codeの音声モード

Claude Codeの音声モードを使用すると、手を使わずにClaude Codeと継続的な双方向会話を行うことができます。

このモードは、新しいClaude Codeフックを使用して、Claudeが動作中に音声入力を提供します。

これにより、Claudeに対して継続的に話しかけることができ、Claudeが行っている作業を中断することなく、中断、方向転換、またはフィードバックを提供することができます。

オプションで、テキスト読み上げ機能を有効にすると、Claudeがあなたに話しかけてくれます。

音声認識とテキスト読み上げはブラウザで処理されるため、ダウンロードするものは何もなく、APIキーも必要ありません。

🎥 デモ動画

📦 インストール

インストールは簡単です。

1. Claude Codeをインストールする

npm install -g @anthropic-ai/claude-code

2. 音声モードをインストールする

npx mcp-voice-hooks@latest install-hooks
claude mcp add voice-hooks npx mcp-voice-hooks@latest

💻 使用例

1. Claude Codeを起動する

claude

2. 音声入力を開始する

ブラウザインターフェイスが3秒後に自動的に開きます（http://localhost:5111）。 「音声入力を開始」をクリックします。

3. 話しかける

Claudeに何かを話しかけます。会話を開始するには、Claude Code CLIで1つのメッセージを送信する必要があります。

4. トリガーワードモード（オプション）

デフォルトでは、一時停止すると発話が自動的に送信されます。ブラウザインターフェイスで「トリガーワードを待つ」モードに切り替えることができます。

1. 「トリガーワードを待つ」モードに切り替えます。
2. トリガーワード（例：「send」、「claude」、「go」）を入力します。
3. メッセージを話しかける - ブラウザにキューに入ります。
4. トリガーワードを言って、キューに入っているすべてのメッセージを一度に送信します（または「今すぐ送信」をクリックします）。

トリガーワードは大文字と小文字を区別せず、送信前にメッセージから自動的に削除されます。

🌐 ブラウザ互換性

• ✅ Chrome：音声認識、ブラウザのテキスト読み上げ、およびシステムのテキスト読み上げを完全にサポートしています。
• ⚠️ Safari：音声認識とシステムのテキスト読み上げを完全にサポートしていますが、ブラウザのテキスト読み上げでは高品質の音声を読み込めません。
• ❌ Edge：Apple Siliconでは音声認識が機能しません（言語がサポートされていないエラー）。

🗣️ 音声応答

音声応答には2つのオプションがあります。

1. ブラウザのテキスト読み上げ
2. システムのテキスト読み上げ

高品質のシステム音声の選択とダウンロード（Macのみ）

Macには組み込みのテキスト読み上げ機能がありますが、高品質の音声はデフォルトでは利用できません。

システムの音声メニューから高品質の音声をダウンロードすることができます：システム設定 > アクセシビリティ > 音声コンテンツ > システム音声

システム音声のドロップダウンメニューの横にある情報アイコンをクリックします。「Siri」を検索して、最高品質の音声を見つけます。音声をダウンロードする必要があります。

ダウンロードが完了したら、Chromeのブラウザ音声（ローカル）メニューで選択することができます。

以下のbashコマンドでテストしてください：

say "Hi, this is your Mac system voice"

音声フックでSiriの音声を使用するには、システム音声を設定し、音声フックのブラウザインターフェイスで「Macシステム音声」を選択する必要があります。

他のダウンロードした音声は、音声フックのブラウザインターフェイスの音声ドロップダウンメニューに表示されるので、「Macシステム音声」オプションを使用する代わりに、そこで直接選択することができます。

Safariには、ブラウザを再起動した後にブラウザのテキスト読み上げで高品質の音声を読み込めないというバグがあります。これはSafariのWeb Speech APIの制限です。Safariで高品質の音声を使用するには、システム音声をSiriに設定し、音声フックのブラウザインターフェイスで「Macシステム音声」を選択する必要があります。

🛠️ 手動でのフックインストール

MCPサーバーが起動すると、フックは自動的にインストール/更新されます。ただし、フックを手動でインストールまたは再構成する必要がある場合は、次のコマンドを実行します。

npx mcp-voice-hooks install-hooks

これにより、プロジェクトの.claude/settings.local.jsonに必要なフックコマンドが設定されます。

🗑️ アンインストール

MCP音声フックを完全に削除するには、次のコマンドを実行します。

# Claude MCPサーバーから削除する
claude mcp remove voice-hooks

# フックと設定も削除する
npx mcp-voice-hooks uninstall

これにより、以下のことが行われます。

• プロジェクトの.claude/settings.local.jsonから音声フックが削除されます。
• 追加したカスタムフックは保持されます。

⚙️ 設定

ポート設定

デフォルトのポートは5111です。別のポートを使用するには、プロジェクトの.claude/settings.local.jsonでMCP_VOICE_HOOKS_PORT環境変数を設定します。

{
  "env": {
    "MCP_VOICE_HOOKS_PORT": "8080"
  }
}

この環境変数は、以下の両方で使用されます。

• MCPサーバーがリッスンするポートを決定するため
• Claude Codeフックが正しいポートに接続するため

注意：.claude/settings.local.jsonでこれを設定することが推奨されます。環境変数はMCPサーバープロセスとフックコマンドの両方で使用できます。

ブラウザの自動開啟

MCP管理モードで実行する場合、フロントエンドが3秒以内に接続しないと、ブラウザが自動的に開きます。この動作を無効にするには、次のように設定します。

{
  "env": {
    "MCP_VOICE_HOOKS_AUTO_OPEN_BROWSER": "false"
  }
}

⚠️ 実験的な代替インストール方法 - プラグインモード

プロジェクトの.claude/settings.local.jsonに以下を追加して、Claude Codeを再起動します。

{
  "extraKnownMarketplaces": {
    "mcp-voice-hooks-marketplace": {
      "source": {
        "source": "git",
        "url": "https://github.com/johnmatthewtennant/mcp-voice-hooks.git"
      }
    }
  },
  "enabledPlugins": {
    "mcp-voice-hooks-plugin@mcp-voice-hooks-marketplace": true
  }
}

一時的にプラグインを無効にする場合は、enabledをfalseに設定します。