Windows Tts MCP

🚀 Windows TTS MCP Server

A Windows PowerShell-based Text-to-Speech server for Claude Desktop

Windows TTS MCP Server is an MCP (Model Context Protocol) server that converts text to speech in Claude Desktop. It utilizes Windows' built-in Speech API through PowerShell to provide a stable and fast TTS function.

✨ Features

• 🎵 Stable TTS: Ensures thread safety based on Windows PowerShell.
• ⚡ Fast Response: Provides immediate response with background playback.
• 🎛️ Diverse Options: Allows adjustment of speed and volume.
• ⏹️ Full Control: Enables stopping playback, forced termination, and status checking.
• 🚨 Emergency Function: Mutes the entire system.
• 📦 Easy Installation: One-click installation and execution with uvx.

🚀 Installation and Execution

Run with uvx (Recommended)

# Run the package
uvx windows-tts-mcp

# Development mode
uvx --from . tts-dev

# Run directly from GitHub (Future)
uvx --from git+https://github.com/yourusername/windows-tts-mcp windows-tts-mcp

Local Development

# Clone the repository
git clone https://github.com/yourusername/windows-tts-mcp
cd windows-tts-mcp

# Run locally
uvx --from . windows-tts-mcp

# Development mode
uvx --from . tts-dev

🎛️ Claude Desktop Configuration

Add the following to the Claude Desktop configuration file:

{
  "mcpServers": {
    "windows-tts": {
      "command": "uvx",
      "args": ["--from", "D:\\MCP\\windows_tts_mcp", "windows-tts-mcp"]
    }
  }
}

Configuration file locations:

• Windows: %APPDATA%\\Claude\\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/claude/claude_desktop_config.json

💻 Usage Examples

📢 Basic Usage

• "Read this text aloud"
• "Play the following content as voice"
• "Play the answer as voice"

⚡ Advanced Usage - Speed Adjustment

• "Read faster: [text]"
• "Read slower: [text]"
• "Read in a low voice: [text]"

⏹️ Advanced Usage - Playback Control

• "Stop the voice playback"
• "Check the TTS status"
• "Forcefully terminate all voice playback"
• "Emergency mute" (Mute the entire system)

🛠️ Tool List

🔧 Technical Details

System Requirements

• Operating System: Windows 10/11
• Python: 3.11 or higher
• PowerShell: 5.0 or higher (Included in Windows by default)
• Others: Windows Speech Platform (Included by default)

Architecture

Claude Desktop
    ↓ (MCP Protocol)
Windows TTS MCP Server
    ↓ (subprocess)
PowerShell
    ↓ (System.Speech)
Windows Speech API
    ↓
Audio Output

Features

• Thread Safety: Handles each TTS request in a separate thread.
• Process Management: Tracks and controls all running TTS processes.
• Error Handling: Robustly handles timeouts and exceptions.
• Resource Cleanup: Automatically cleans up completed processes.

🐛 Troubleshooting

No voice output

1. Check Windows audio

   # Test directly in PowerShell
   Add-Type -AssemblyName System.Speech
   $synth = New-Object System.Speech.Synthesis.SpeechSynthesizer
   $synth.Speak("Test")
   

2. Check volume settings

   • Check the PowerShell volume in the Windows volume mixer.
   • Check the system default audio device settings.

3. Check the Speech Platform

   • Go to Windows Settings → Time & Language → Speech.
   • Check the speech recognition language settings.

Processes remain

# Force cleanup
uvx windows-tts-mcp
# Execute "Forcefully terminate all TTS" in Claude

📝 Development

Project Structure

windows-tts-mcp/
├── pyproject.toml          # Package configuration
├── README.md               # This file
├── windows_tts_mcp/        # Main package
│   ├── __init__.py
│   └── main.py            # TTS server code
├── .gitignore
└── uv.lock

Development Environment Setup

# Clone the repository
git clone https://github.com/yourusername/windows-tts-mcp
cd windows-tts-mcp

# Install dependencies with uv
uv sync

# Run in development mode
uvx --from . tts-dev

Contributing

1. Fork this repository.
2. Create a new branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

📄 License

This project is distributed under the MIT License. See the LICENSE file for details.

🙏 Acknowledgments

• Anthropic - Development of Claude and MCP.
• Model Context Protocol - Provides the MCP standard.
• uv - Modern Python package management.

🔗 Related Links

• Official documentation of Model Context Protocol
• Download Claude Desktop
• Official documentation of uv

Made with ❤️ for Claude Desktop users