mac-voice-mcp

🎙️ mac-voice-mcp

MacでClaudeと声に出して会話できます。
自然なターン交代 · デバイス上での音声認識 · 音声がコンピューターの外に出ることはありません

---

ClaudeはMacのスピーカーから話しかけ、相手と会話するようにあなたの返事を聞き、話した内容をテキストとして受け取ります。音声認識はMac上で実行されるため、音声がコンピューターの外に出ることはありません。

Claude ──speak_and_listen("Tests pass. Open the PR?")──▶  🔊 "Tests pass. Open the PR?"
                                                         🎙 you: "yes, and tag Priya"
Claude ◀──────────────── "Yes, and tag Priya." ─────────  whisper.cpp on your Mac

こんな用途に最適です：

• 長時間のタスク：Claudeは静かに作業し、判断が必要になると声で確認するため、画面から離れていても大丈夫です。
• 手短なレビュー：プルリクエストの概要を20秒で聞き、「承認しますか？」と確認できます。
• 長い一日の終わりに、目や手首を休めたいとき。
• 考えを声に出す：入力する代わりに、問題について話しながら考えられます。

機能

• 🔒 デバイス上で処理。 whisper.cppがMac上で文字起こしします。録音データはターンごとに削除されます。
• 💬 自然なターン交代。 小さなチャイムの後、話し始めるのを待ち、話し終えてから約1.5秒後に応答します。プッシュ・トゥ・トークは不要です。
• ⚡ すばやい応答。 whisper.cppサーバーがモデルを読み込んだ状態に保つため、Apple Siliconでは文字起こしにかかる時間はほんのわずかです。
• 🗣️ お好みで自然な音声を。 macOSで最も適した音声、またはオプションのKokoroニューラル音声を使用します。
• ✋ インストール前に確認。 セットアップでは既存の環境を確認し、利用できるものを再利用します。
• 🙋 Claudeの作業中に話しかけられます。 作業の途中で「Claude、別のブランチを使って」と伝えると、次の手順でその指示が反映されます（Claude Codeプラグイン）。
• 🫧 Voice Buddy（オプション、Claude Code）。 プロンプトの上に表示されるアニメーションの相棒が、Claudeの発話中や聞き取り中を示します。最初のキー入力で発話を中断できます。
• 🪟 マイク1つで複数のウィンドウに対応。 Claude Code、Claude Desktop、Cursorが順番に使うため、同時に話して重なることはありません。
• 📏 推測ではなく測定。 doctorがMac上のパイプライン全体を確認し、PASS、WARN、FAILで評価します。

クイックスタート

Mac が必要です（Apple Silicon を推奨）。Node.js 22 以降も必要です。

1. インストールします。

• Claude Code（推奨）。プラグインをインストールすると、Voice Buddy も一緒にインストールされます。

  /plugin marketplace add jeet0007/mac-voice-mcp
  /plugin install mac-voice-mcp@mac-voice-mcp
  /plugin install voice-buddy@mac-voice-mcp
  

  Voice Buddy は任意です。プロンプトの上にアニメーションする相棒を表示し、入力して割り込めるようにします（詳細）。

• Cursor または VS Code：

• Claude Desktop やその他のアプリ： npx -y mac-voice-mcp@latest を stdio MCP サーバーとして追加します。各アプリの手順はインストールをご覧ください。

2. セットアップします。 Claude に *「音声をセットアップして」*と頼むか、/mac-voice-mcp:setup を実行します。SoX、whisper.cpp、音声モデルがあるか確認し、不足しているものを表示します。あなたが許可した後にのみインストールします。

3. マイクを許可します。 Claude が初めて聞き取るときに、macOS から確認されます。許可をクリックします。

4. 話しかけます。 /mac-voice-mcp:talk 不安定なログインテストを修正して を実行するか、Claude に *「判断が必要なときは音声で確認して」*と頼みます。チャイムの後に返答してください。

プロンプトなしで音声のやり取りを許可する

Claude が話すたびに Claude Code が承認を求めるため、会話の流れが途切れてしまいます。音声のやり取りを許可するには、~/.claude/settings.json の permissions.allow にツールを追加します。

{
  "permissions": {
    "allow": [
      "mcp__plugin_mac-voice-mcp_voice-mcp__speak_and_listen",
      "mcp__voice-mcp__speak_and_listen"
    ]
  }
}

最初の名前はプラグイン用、2 つ目の名前は claude mcp add voice-mcp … 用です。voice_setup は含めないでください。そうすれば、インストール時に引き続き確認が求められます。

仕組み

サーバーには 2 つのツールと 2 つのプロンプトがあります。

	機能
speak_and_listen	短いメッセージを読み上げ、会話の 1 ターンを聞き取って、文字起こしを返します。
voice_setup	インストール済みのものを確認します。あなたが同意すると、不足しているものだけをインストールします。
setup prompt	ガイド付きのセットアップです。確認し、質問し、インストールしてから、音声テストを実行します。
voice_mode prompt	Claude が自然なタイミングで音声で確認する、ハンズフリーのセッションです。

Claude には、耳で聞いて分かりやすい文章を書くよう指示しています。短い文を使い、マークダウンを避け、パスではなくファイル名を使います。読み上げに向かない内容があれば、読み上げる前に書き換えます。Claude Code では、入力するまで音声会話が続くよう、プラグインが音声モードを維持します。詳しくは使い方をご覧ください。

トラブルシューティング

まず npx -y mac-voice-mcp@latest doctor を実行してください。セットアップ、音声と文字起こし、スピーカーとマイクをテストし、どこで問題が起きているかを知らせます。

症状	対処方法
「マイクから完全なデジタル無音が返された」と表示される	システム設定 → プライバシーとセキュリティ → マイクで、アプリ（Claude、Cursor、またはターミナル）にマイクの使用を許可してから、アプリを再起動します。
考えている途中で音声が途切れる	VOICE_MCP_END_SILENCE_MS=2000 を設定します。
音声がロボットのように聞こえる	Premium macOS voice をダウンロードするか、Kokoro をインストールします。音声をご覧ください。
毎回承認を求められる	プロンプトなしで音声のやり取りを許可するをご覧ください。

詳しくはトラブルシューティングをご覧ください。

ドキュメント

• インストール：各アプリ、MCP Registry、クローンからのインストール、アップグレード。
• 音声：macOS Premium 音声と、オプションの Kokoro 音声。
• 使い方：音声モード、Claude の作業中に話す方法、Voice Buddy、複数のセッション。
• 設定：すべての設定と音声モデル。
• トラブルシューティング：よくある問題と既知の制限。
• プライバシーとセキュリティ：Mac 上に保持されるデータと、プロジェクトのセキュリティ対策。
• 開発：ビルド、テスト、リリース。
• 変更履歴

🤖 Vibe-coded

このプロジェクトは、Claude との対話を通じて設計・作成されました。人間（私）が方向性を示し、実際の Mac でテストしてテストスイートを確認しましたが、コードの大半は AI が作成しました。利用する前に免責事項をお読みください。

免責事項

mac-voice-mcp は、無料のオープンソース個人プロジェクトです。いかなる種類の保証もなく、現状有姿で提供されます。作者は、本プロジェクトの利用による損害や損失について責任を負いません。正確な条件については、LICENSEをご覧ください。簡単に説明すると、次のとおりです。

• AI アシスタントが speak_and_listen を呼び出すたびに、マイクがオンになり、スピーカーから音声が再生されます。
• **音声認識は間違えることがあります。**アシスタントが聞き間違えた言葉に基づいて操作する可能性があります。ファイルの削除、コードのプッシュ、メッセージの送信など、取り消せない操作を許可する前に、認識結果を確認してください。
• Mac にソフトウェアをインストールしますが、インストールは同意した場合に限ります。Homebrew パッケージと、Kokoro 音声を選択した場合の npm による kokoro-js が対象です。これらはそれぞれ独立したプロジェクトであり、各自のライセンスが適用されます（下記参照）。
• **サポートを保証するものではありません。**Issue とプルリクエストは歓迎します。対応は可能な範囲で行います。

**商標について。**Apple、Mac、macOS、Siri は Apple Inc. の商標です。Claude は Anthropic の商標です。mac-voice-mcp は独立したプロジェクトであり、Apple または Anthropic とは提携関係になく、両社から支援や承認を受けていません。

サードパーティソフトウェア

mac-voice-mcp は、これらのソフトウェアを同梱していません。Mac にインストールされている場合に使用し、インストールするのは同意を得た場合に限ります。それぞれに独自のライセンスが適用されます。

ソフトウェア	用途	ライセンス
SoX	マイクからの録音、Kokoro の再生	GPL-2.0
whisper.cpp	音声テキスト変換	MIT
Whisper models (OpenAI)	音声テキスト変換	MIT
macOS voices (say)	内蔵音声	Apple の macOS ライセンス
kokoro-js (オプション)	Kokoro 音声	Apache-2.0
Kokoro-82M model (オプション)	Kokoro 音声	Apache-2.0
espeak-ng (オプション、kokoro-js 内)	Kokoro 用のテキストから音声への変換	GPL-3.0
ffmpeg (フォールバック用。セットアップではインストールされません)	SoX がない場合の録音	LGPL-2.1 / GPL

ライセンス

MIT © Jeet