VoiceMode MCP — حالات الاستخدام, التثبيت & عرض مباشر

لماذا تستخدمه

الميزات الأساسية

Local Whisper option — no cloud audio
Multiple TTS backends: OpenAI, ElevenLabs, local Coqui
Push-to-talk or voice-activated modes
Streams partial responses so you hear Claude thinking
Works in terminal alongside Claude Code CLI

عرض مباشر

كيف يبدو في الممارسة

voicemode-mcp.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "voicemode-mcp": {
      "command": "uvx",
      "args": [
        "voice-mode"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "voicemode-mcp": {
      "command": "uvx",
      "args": [
        "voice-mode"
      ]
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "voicemode-mcp": {
      "command": "uvx",
      "args": [
        "voice-mode"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "voicemode-mcp": {
      "command": "uvx",
      "args": [
        "voice-mode"
      ]
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "voicemode-mcp",
      "command": "uvx",
      "args": [
        "voice-mode"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json

{
  "context_servers": {
    "voicemode-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "voice-mode"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add voicemode-mcp -- uvx voice-mode

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: VoiceMode

Drive a Claude Code session hands-free while reading on another screen

👤 Devs who read docs or designs on one monitor while coding ⏱ ~30 min intermediate

متى تستخدمه: You're reading a design doc and want to dictate changes without alt-tabbing.

المتطلبات الأساسية

Microphone + speakers — System audio configured — test with say "hello" or equivalent
Whisper model ready — voice-mode install-whisper downloads the local model

الخطوات

Start voice

Use voicemode. Listen for prompts and speak responses. Repeat after me: "ready"✓ تم النسخ

→ TTS plays "ready"
Dictate a change

[spoken] Update src/auth.ts — use bcrypt instead of plain SHA256 for passwords.✓ تم النسخ

→ Transcription correct; change applied; TTS confirms
Review

[spoken] Read me the diff.✓ تم النسخ

→ TTS reads diff in chunks, pausable

النتيجة: A working session where your hands never leave what they were doing.

المزالق

TTS talking over your prompts — Enable push-to-talk mode or a wake word

اجمعها مع: filesystem

Code by voice for accessibility or RSI recovery

👤 Devs with RSI, low vision, or preferring speech input ⏱ ~60 min intermediate

متى تستخدمه: You can't type for a while and need to keep shipping.

المتطلبات الأساسية

Tolerable ambient noise — Quiet room; headset mic beats laptop mic

الخطوات

Baseline

[spoken] Use voicemode. Read the latest git diff out loud, pausing between files.✓ تم النسخ

→ Clear TTS read
Workflow

[spoken] Refactor the user model in src/models/user.ts. Move password hashing into a method. Show me the plan first.✓ تم النسخ

→ Plan spoken; confirmation required before changes

النتيجة: A full coding session without keyboard input.

المزالق

Code symbols mispronounced by TTS — Configure the TTS phoneme dictionary for common programming terms

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

voicemode-mcp + filesystem

Voice-dictated code changes land in the repo

I'll dictate changes; apply them in files after reading each back.✓ تم النسخ

voicemode-mcp + github

Dictate a PR description after voice-reviewing the diff

Read me the staged changes, then open a PR with a description I'll dictate.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها	التكلفة
start_listening	mode: "ptt"\|"vad"	Begin a voice session	free or OpenAI Whisper API
speak	text: str, voice?: str	Any time Claude wants to surface something audibly	TTS provider-dependent
transcribe_last	none	Fetch what the user just said	Whisper call
stop_listening	none	End voice session	free

التكلفة والحدود

تكلفة التشغيل

حصة API: Local: free. OpenAI Whisper: $0.006/min. ElevenLabs TTS: ~$0.30/1k chars.
الرموز لكل استدعاء: Audio pipelines are not token-costed directly
التكلفة المالية: Free with local stack; metered with cloud providers
نصيحة: Local Whisper + Coqui TTS is totally free but lower quality — start cloud, downgrade later

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: microphone speakers

تخزين بيانات الاعتماد: TTS/STT API keys in env

نقل البيانات الخارجي: Voice audio to TTS/STT provider if not local

Never use cloud STT in calls with confidential audio unless you trust the provider's retention policy

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Mic not detected

System audio permission — grant terminal/Claude Code mic access

تحقق: `voice-mode test-mic` prints levels

TTS sounds robotic

Default is Coqui local — switch to OpenAI tts-1-hd via VOICE_MODE_TTS=openai

Lag between my speech and response

Use local Whisper-tiny for STT; cloud adds 500ms+

البدائل

VoiceMode مقابل البدائل

البديل	متى تستخدمها	المقايضة
macOS Dictation + say command	You just want basic OS-level voice	No integration with Claude's output — one-way only
Superwhisper / Wispr Flow	You want a polished native macOS dictation app	Not MCP-integrated; no agent-level workflows

VoiceMode

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

التثبيت

اختر العميل

حالات الاستخدام

استخدامات عملية: VoiceMode

Drive a Claude Code session hands-free while reading on another screen

المتطلبات الأساسية

الخطوات

المزالق

Code by voice for accessibility or RSI recovery

المتطلبات الأساسية

الخطوات

المزالق

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

الأدوات

ما يوفره هذا الـ MCP

التكلفة والحدود

تكلفة التشغيل

الأمان

الصلاحيات والأسرار ونطاق الأثر

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

البدائل

VoiceMode مقابل البدائل

المزيد

الموارد