Voice Recorder (Whisper)

🚀 語音錄音 MCP 服務器

語音錄音 MCP 服務器可用於錄音，並藉助 OpenAI 的 Whisper 模型對音頻進行轉錄。它既可以作為 Goose AI 代理的自定義擴展運行，也能作為獨立的 MCP 服務器使用。

🚀 快速開始

語音錄音 MCP 服務器功能強大，能滿足多種音頻處理需求。你可以根據自身需求，將其作為獨立服務器運行，或集成到 Goose AI 代理中使用。

✨ 主要特性

• 可從默認麥克風錄製音頻。
• 利用 Whisper 模型對錄製的音頻進行轉錄。
• 能夠集成到 Goose AI 代理，作為自定義擴展使用。
• 包含常見錄音場景的提示，方便用戶操作。

📦 安裝指南

# 從源代碼安裝
git clone https://github.com/DefiBax/voice-recorder-mcp.git
cd voice-recorder-mcp
pip install -e .

💻 使用示例

基礎用法

作為獨立 MCP 服務器

# 使用默認設置運行（base.en 模型）
voice-recorder-mcp

# 使用特定的 Whisper 模型
voice-recorder-mcp --model medium.en

# 調整採樣率
voice-recorder-mcp --sample-rate 44100

使用 MCP 檢查器測試

MCP 檢查器提供一個交互界面用於測試服務器：

# 安裝 MCP 檢查器
npm install -g @modelcontextprotocol/inspector

# 運行檢查器並連接到服務器
npx @modelcontextprotocol/inspector voice-recorder-mcp

與 Goose AI 代理結合使用

1. 打開 Goose 並轉到設置 > 擴展 > 添加 > 命令行擴展。

2. 設置名稱為 voice-recorder。

3. 在命令字段中輸入語音錄音器 MCP 可執行文件的完整路徑：

   /full/path/to/voice-recorder-mcp
   

   或指定模型：

   /full/path/to/voice-recorder-mcp --model medium.en
   

   查找路徑方法：

   which voice-recorder-mcp
   

4. 基本功能無需設置環境變量。

5. 啟動與 Goose 的對話，並通過以下指令引入錄音器： "我希望您能根據語音錄音器返回的轉錄文本執行操作。例如，當我 dictation 一個計算如 1+1，請返回結果。"

高級用法

此服務器提供了一些可用工具，方便用戶進行音頻錄製和轉錄操作：

• start_recording：開始從默認麥克風錄製音頻。
• stop_and_transcribe：停止錄音並轉錄音頻為文本。
• record_and_transcribe：按指定時長錄音並轉錄。

📚 詳細文檔

Whisper 模型

此擴展支持多種 Whisper 模型：

要求

• Python 3.6+
• 具備麥克風的硬件設備

配置

通過環境變量配置服務器行為：

# 示例配置命令：
export VOICE_RECORDER_API_KEY=your_api_key_here

故障排除

常見問題及解決方法：

1. 無法錄音：檢查麥克風權限和驅動程序。
2. 轉錄錯誤：確保 API 密鑰正確且服務可用。

貢獻指南

參與項目的方法：

1. Fork 倉庫到個人賬戶。
2. 創建新分支進行功能開發。
3. 提交代碼並創建 Pull Request。
4. 參與問題討論和修復。

🔧 技術細節

語音錄音 MCP 服務器依賴 Python 3.6+ 環境運行，通過調用 OpenAI 的 Whisper 模型實現音頻轉錄功能。它支持通過環境變量配置服務器行為，並且可以與 Goose AI 代理集成，為用戶提供更加便捷的音頻處理體驗。

📄 許可證

項目使用 MIT 許可證，詳細信息見 LICENSE 文件。