ybouhjira/claude-code-tts

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

21 stars 14 forks Качество 55 Тренд 10MIT

Repository Install

🔊 Text-to-Speech MCP plugin for Claude Code - hear audio feedback while coding (OpenAI TTS)

Обзор

A Text-to-Speech MCP server plugin for Claude Code that converts text to speech using OpenAI's TTS API. Get audio feedback from Claude as you work! - : Every Claude response is automatically spoken (via Stop hook) - : alloy, echo, fable, onyx, nova, shimmer - : Non-blocking queue with concurrent processing - : One audio plays at a time, no overlapping - : macOS (afplay), Linux (mpv/ffplay/mpg123), Windows (PowerShell) - : speak-text binary for direct TTS without MCP - (for building from source) - with TTS access - : - macOS: afplay (built-in) - Linux: mpv, ffplay, or mpg123 - Windows: PowerShell (built-in) Or add to your shell profile (~/.zshrc or ~/.bashrc). Convert text to speech and play it aloud. Get the current status of the TTS system. This plugin includes a that automatically speaks the first sentence of every Claude response. No configuration needed - it just works. The hook runs in the background and won't block Claude's responses.

README

Показан фрагмент оригинального README. Открыть оригинал.

Claude Code TTS Plugin

A Text-to-Speech MCP server plugin for Claude Code that converts text to speech using OpenAI’s TTS API. Get audio feedback from Claude as you work!

Features

Deterministic Auto-Speak: Every Claude response is automatically spoken (via Stop hook)
6 High-Quality Voices: alloy, echo, fable, onyx, nova, shimmer
Worker Pool Architecture: Non-blocking queue with concurrent processing
Mutex-Protected Playback: One audio plays at a time, no overlapping
Cross-Platform: macOS (afplay), Linux (mpv/ffplay/mpg123), Windows (PowerShell)
Standalone CLI: speak-text binary for direct TTS without MCP

Quick Install

# One-liner installation
curl -fsSL https://raw.githubusercontent.com/ybouhjira/claude-code-tts/main/install.sh | bash

Or install manually:

git clone https://github.com/ybouhjira/claude-code-tts.git ~/.claude/plugins/claude-code-tts
cd ~/.claude/plugins/claude-code-tts
make install

Requirements

Go 1.21+ (for building from source)
OpenAI API Key with TTS access
Audio Player:
- macOS: afplay (built-in)
- Linux: mpv, ffplay, or mpg123
- Windows: PowerShell (built-in)

Configuration

Set your OpenAI API key:

export OPENAI_API_KEY="sk-..."

Or add to your shell profile (~/.zshrc or ~/.bashrc).

Architecture

┌─────────────────────────────────────────────────────────────┐
│                     Claude Code                              │
│                         │                                    │
│                    MCP Protocol                              │
│                         │                                    │
│  ┌──────────────────────▼──────────────────────────────┐    │
│  │              TTS MCP Server (Go)                     │    │
│  │  ┌─────────────────────────────────────────────┐    │    │
│  │  │              Tool Handlers                   │    │    │
│  │  │   speak(text, voice)  │  tts_status()       │    │    │
│  │  └─────────────┬─────────┴─────────────────────┘    │    │
│  │                │                                     │    │
│  │  ┌─────────────▼─────────────────────────────┐      │    │
│  │  │           Worker Pool (2 workers)          │      │    │
│  │  │  ┌─────────┐    ┌─────────────────────┐   │      │    │
│  │  │  │ Job     │───►│ Queue (50 slots)    │   │      │    │

Открыть полный README на GitHub