speaktome-mcp

# SpeakToMe MCP SpeakToMe MCP is a local Python MCP server for Linux. It records from a microphone on the same machine, transcribes rolling audio windows with a local `faster-whisper` `small` model, and can also speak local text through `espeak-ng`, all over stdio. ## Scope - Linux only for v1 - stdio transport only - local microphone capture through `sounddevice` - local transcription through `faster-whisper` - rolling duration based listening started by `start_listening(duration_seconds=...)` - transcript returned by `poll_transcription(session_id)` when the session is stopped - one active in-memory session at a time - local text to speech through `espeak-ng` ## Prerequisites You need: - Linux - Python 3.11 or newer - a working microphone input device - system audio libraries required by `sounddevice`, usually PortAudio plus ALSA or PipeWire user-space packages on Linux - `espeak-ng` installed if you want to use `speak_text` If you want the `uv` workflow, install [`uv`](https://docs.astral.sh/uv/). If `sounddevice` cannot open devices, install the PortAudio runtime or development package used by your distro, then confirm your normal desktop audio stack is working. If `speak_text` fails, confirm `espeak-ng` is installed and available on `PATH` for the same Linux user session that starts the MCP host. ## Install ### Install from PyPI ```bash pip install speaktome-mcp ``` ### Install from GitHub ```bash pip install git+https://github.com/alma3lol/SpeakToMeMCP.git ``` ### Install from local source or an unpacked source archive Download the repository source, or unpack a release source archive, then run: ```bash pip install . ``` ### Install a development environment with uv ```bash uv sync --locked --all-extras --dev ``` ## Run and verify the CLI Installed console script: ```bash speaktome-mcp --help ``` Start the server with the installed console script: ```bash speaktome-mcp ``` Module entrypoint fallback: ```bash python -m speaktome_mcp --h…