clvoice-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CLVOICE_STT | No | STT engine: groq or gemini. | groq |
| CLVOICE_LANG | No | Spoken language: auto, vi, or en. | auto |
| GROQ_API_KEY | No | Groq API key (required if using groq). | |
| CLVOICE_CLEAN | No | Clean filler words via Groq LLM (set to '0' to disable). | true |
| CLVOICE_HOTKEY | No | Host the push-to-talk watcher in the server (set to '0' to disable). | true |
| GEMINI_API_KEY | No | Gemini API key (required if using gemini). | |
| CLVOICE_AUTO_PASTE | No | Auto-paste into focused window (set to 'false' for clipboard only). | true |
| CLVOICE_GROQ_MODEL | No | Groq Whisper model. | whisper-large-v3-turbo |
| CLVOICE_MIC_DEVICE | No | Exact dshow mic name (default: first input). | |
| CLVOICE_CLEAN_MODEL | No | Groq chat model for cleanup. | llama-3.3-70b-versatile |
| CLVOICE_FFMPEG_PATH | No | Path to the ffmpeg binary. | ffmpeg |
| CLVOICE_MAX_SECONDS | No | Hard cap on record duration. | 60 |
| CLVOICE_GEMINI_MODEL | No | Gemini model. | gemini-2.5-flash |
| CLVOICE_DEFAULT_SECONDS | No | Default record duration for MCP tool. | 15 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| voice_listenA | Record the microphone for a few seconds, transcribe the speech (Vietnamese or English), and place the text into the user's input box (clipboard + optional auto-paste) for them to edit. It does NOT return the transcript and must NOT be executed: after calling, just confirm briefly and wait for the user's next (edited) message. Use when the user wants to dictate input. |
| list_audio_devicesA | List available microphone input device names so the user can set CLVOICE_MIC_DEVICE. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one for dictation and transcription, the other for listing audio devices. No overlap in functionality.
Both tool names follow a consistent verb_noun pattern: 'voice_listen' and 'list_audio_devices', with snake_case and clear action prefixes.
Two tools is appropriate for the narrow scope of voice input: one to configure the device and one to capture input. The tool count matches the domain well.
The server covers the core needs (capture input, list devices). A minor gap is the lack of a tool to set the microphone device directly, but this is handled via environment variable.