Stt MCP Server Linux

[](https://github.com/marcindulak/stt-mcp-server-linux/actions/workflows/test.yml)

[](https://github.com/hesreallyhim/awesome-claude-code)

Co-Authored-By: Claude

Functionality overview

Local speech-to-text MCP server for Linux. The speech-to-text functionality can also be used in a standalone mode in Tmux, without relying on MCP.

Claude Code is required to run inside a Tmux session to enable the transcribed text injection into Claude's input stream.

The MCP server runs in a Docker container with access to host input and audio devices. The server provides a `transcribe` tool accessible through MCP protocol. When the tool is activated, the server monitors the `Right Ctrl` key for push-to-talk functionality. Key press detection uses `/dev/input` keyboard devices. Audio recording uses `/dev/snd` microphone device.

On `Right Ctrl` key release, speech-to-text transcription occurs (using Whisper tiny model by default). The transcribed text is injected into Claude's input stream via Tmux send-keys.

The MCP server is Linux-only due to `/dev` device dependencies.

[!WARNING] This project will create `~/.stt-mcp-server-linux` directory.

Usage examples

The instructions follow below.

1. Install [Docker Engine](https://docs.docker.com/engine/install/) or [Docker Desktop](https://docs.docker.com/desktop/)

2. Install [Tmux](https://github.com/tmux/tmux). If you are unfamiliar with, Tmux watch this [YouTube tutorial](https://www.youtube.com/watch?v=UxbiDtEXuxg&list=PLT98CRl2KxKGiyV1u6wHDV8VwcQdzfuKe) and checkout out this [cheat sheet](https://tmuxcheatsheet.com) for a shortcuts reference.

3. Clone this repository, and `cd` into it:

   git clone https://github.com/marcindulak/stt-mcp-server-linux
   cd stt-mcp-server-linux
   export STT_MCP_SERVER_LINUX_PATH=$(pwd)

4. Build the Docker image of the MCP server:

   bash scripts/build_docker_image.sh

5. Download the Whisper tiny model under `~/.stt-mcp-server-linux/whisper`:

...