stt-mcp-server-linux
🥈SilverLocal speech-to-text MCP server for Linux, enabling hands-free control of Tmux sessions. Ideal for operations teams using Claude Code, it connects to Linux systems and integrates with Tmux workflows for efficient command execution.
2240Updated Yesterday
Intermediate30min to implementautomation
Saves ~45 min per use
Quick InstallView Source
git clone https://github.com/marcindulak/stt-mcp-server-linux.gitWorks with:
Claude
Overview
About This Skill
stt-mcp-server-linux is a local speech-to-text MCP server designed for Linux systems, enabling hands-free control through push-to-talk functionality via the Right Ctrl key. It integrates directly with Tmux sessions and Claude Code, allowing transcribed text to be injected into the input stream for seamless command execution. The server runs in a Docker container with access to host input and audio devices, using the Whisper tiny model for transcription by default. It supports both MCP mode for integration with Claude and standalone mode for direct Tmux use. The tool is ideal for operations teams, developers, and system administrators seeking efficient voice-controlled workflows.
How to Use
Install Docker and Tmux, clone the repository, build the Docker image, download the Whisper model, configure Tmux settings, and install Claude Code. Run the add_mcp_server_to_claude.sh script to integrate with Claude, then start a Tmux session with Claude and use the transcribe tool. Press Right Ctrl to activate push-to-talk, then release to transcribe and inject text.
Use Cases
Hands-free command execution in Tmux sessions using voice
Voice-controlled Claude Code interactions within terminal environments
Accessibility enhancement for developers with mobility constraints
Rapid terminal command input without typing in operations workflows
Tags
Setup & Installation
Quick Install
No install command available. Check the GitHub repository for manual installation instructions.
Alternative Install (Git Clone)
git clone https://github.com/marcindulak/stt-mcp-server-linuxRequirements
- Claude Code or compatible AI agent
- Works with: Claude
Quick Start Guide
1
Install the Skill
Copy the install command above and run it in your terminal.
2
Open Your AI Agent
Launch Claude Code, Cursor, or your preferred AI coding agent.
3
Try It Out
Use the prompt template or examples below to test the skill.
4
Customize
Adapt the skill to your specific use case and workflow.
Usage Examples
Prompt Template
Set up a local speech-to-text MCP server on my Linux system. I want to control my Tmux sessions using voice commands. My [COMPANY] is in the [INDUSTRY] sector, and I need to process [DATA] efficiently. Guide me through the installation and configuration process.
Example Output
# Local Speech-to-Text MCP Server Setup Guide ## Prerequisites - Linux system (Ubuntu 20.04 LTS recommended) - Tmux installed - Python 3.8 or higher - Basic familiarity with command line ## Installation Steps 1. **Clone the repository**: ```bash git clone https://github.com/yourusername/stt-mcp-server-linux.git cd stt-mcp-server-linux ``` 2. **Install dependencies**: ```bash pip install -r requirements.txt ``` 3. **Configure the server**: - Edit the `config.ini` file to match your system settings. - Set the correct Tmux socket path if needed. ## Usage - Start the server: ```bash python server.py ``` - Use voice commands to control your Tmux sessions. ## Troubleshooting - If you encounter issues, check the logs in the `logs` directory. - Ensure your microphone is properly configured and accessible.
Apply to these tools
Browse all toolsClaude
AI assistant built for thoughtful, nuanced conversation
Microsoft Teams
Get more done every day with Microsoft Teams – powered by AI
Drata
Automate security compliance and monitor real-time security posture seamlessly.
GPT for work
Automate your spreadsheet tasks with AI power
Respell
Agentic AI Workflow platform
Notion
Connected workspace for docs, wikis, and projects
Compatible MCP servers
Browse all MCP servers
Find the right skills for your stack
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan