Back to Home
marcindulak icon

stt-mcp-server-linux

by marcindulak

Overview

Local speech-to-text server for Linux, designed to integrate with Claude Code via the MCP protocol or run in standalone mode to inject transcribed text into a Tmux session.

Installation

Run Command
bash scripts/restart_mcp_server.sh

Environment Variables

  • CONTAINER_NAME
  • DEBUG
  • MODE
  • OUTPUT
  • TMUX_SESSION
  • TMUX_TMPDIR
  • STT_MCP_SERVER_LINUX_PATH
  • BUILDKIT_PROGRESS

Security Notes

The `scripts/restart_mcp_server.sh` uses `eval` to execute the constructed `docker run` command, which is a shell anti-pattern that can lead to command injection vulnerabilities if any of the variables composing `$DOCKER_CMD` were ever sourced from untrusted input. The server requires the Docker container to have direct access to sensitive host devices (`/dev/input` for keyboard monitoring and `/dev/snd` for audio recording) and adds the container user to the `input` group. This grants the container high privileges to interact with the host's hardware, increasing the potential attack surface if the container were compromised. While `TmuxOutputHandler` implements robust input sanitization to prevent command injection when injecting transcribed text into Tmux, the underlying system setup involves elevated privileges and a potentially dangerous shell construct.

Similar Servers

Stats

Interest Score42
Security Score6
Cost ClassHigh
Avg Tokens750
Stars19
Forks2
Last Update2026-01-10

Tags

Speech-to-textMCPLinuxDockerClaudeAITmux