MCP Voice Hooks

🚀 Claude Code語音模式

Claude Code語音模式讓你無需動手，就能與Claude Code進行連續的雙向對話。

它利用全新的Claude Code鉤子，在Claude運行時將語音輸入傳遞給它。

這使你能夠與Claude持續對話——在Claude工作時進行打斷、重新引導或提供反饋，而無需停止它正在執行的任務。

你還可以選擇啟用文本轉語音功能，讓Claude以語音形式回覆你。

語音識別和文本轉語音功能由瀏覽器處理，因此無需下載任何內容，也不需要API密鑰。

🚀 快速開始

✨ 主要特性

• 實現與Claude Code的免提雙向對話。
• 利用Claude Code鉤子即時傳遞語音輸入。
• 支持在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命令行界面中發送一條消息來開啟對話。

4. 觸發詞模式（可選）

默認情況下，當你暫停說話時，話語會自動發送。你可以在瀏覽器界面中切換到“等待觸發詞”模式：

1. 切換到“等待觸發詞”模式。
2. 輸入一個觸發詞（例如，“發送”、“Claude”、“開始”）。
3. 說出你的消息——它們將在瀏覽器中排隊。
4. 說出你的觸發詞以一次性發送所有排隊的消息（或點擊“立即發送”）。

觸發詞不區分大小寫，並且在發送消息前將自動從你的消息中移除。

📚 詳細文檔

瀏覽器兼容性

• ✅ Chrome：全面支持語音識別、瀏覽器文本轉語音和系統文本轉語音。
• ⚠️ Safari：全面支持語音識別和系統文本轉語音，但瀏覽器文本轉語音無法加載高質量語音。
• ❌ Edge：在Apple Silicon上語音識別無法工作（語言不支持錯誤）。

語音回覆

語音回覆有兩種選項：

1. 瀏覽器文本轉語音
2. 系統文本轉語音

選擇並下載高質量系統語音（僅適用於Mac）

Mac自帶文本轉語音功能，但默認情況下沒有高質量語音。 你可以從系統語音菜單下載高質量語音：系統設置 > 輔助功能 > 語音內容 > 系統語音 點擊系統語音下拉菜單旁邊的信息圖標。搜索“Siri”以找到最高質量的語音。你需要觸發語音下載。 下載完成後，你可以在Chrome的“瀏覽器語音（本地）”菜單中選擇它。 使用以下bash命令進行測試：

say "Hi, this is your Mac system voice"

要在語音鉤子中使用Siri語音，你需要設置系統語音，並在語音鉤子瀏覽器界面中選擇“Mac系統語音”。 其他下載的語音將顯示在語音鉤子瀏覽器界面的語音下拉菜單中，你可以直接在那裡選擇它們，而無需使用“Mac系統語音”選項。

Safari存在一個問題，即瀏覽器重啟後，瀏覽器文本轉語音無法加載高質量語音。這是Safari Web語音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。

🔗 演示視頻