Windows TTS MCP Server

Instructions

Implementation Reference

• windows_tts_mcp/main.py:170-202 (handler)

  The handler function for the 'speak' tool. Decorated with @mcp.tool() which registers it in the MCP server. Splits long text into chunks and spawns a background thread to speak each chunk using the powershell_tts helper.
  @mcp.tool() def speak(text: str) -> str: """텍스트를 음성으로 읽어줍니다""" try: # 텍스트 분할 text_chunks = split_text_for_tts(text, 500) total_chunks = len(text_chunks) def _speak_thread(): for i, chunk in enumerate(text_chunks, 1): safe_print(f"[TTS] {i}/{total_chunks} 부분 재생 중: {chunk[:50]}...") success = powershell_tts(chunk) if not success: safe_print(f"[RETRY] TTS 재시도: {chunk[:30]}...") # 한 번 더 시도 powershell_tts(chunk) # 각 청크 사이에 짧은 간격 if i < total_chunks: time.sleep(0.5) # 백그라운드에서 실행 thread = threading.Thread(target=_speak_thread, daemon=True) thread.start() if total_chunks > 1: return f"[START] 음성 재생 시작 ({total_chunks}개 부분으로 분할): '{text[:50]}...'" else: return f"[START] 음성 재생 시작: '{text[:50]}...'" except Exception as e: return f"[ERROR] 음성 재생 오류: {str(e)}"
• windows_tts_mcp/main.py:67-130 (helper)

  Core helper function that runs the actual TTS via PowerShell, invoking System.Speech.Synthesis.SpeechSynthesizer.Speak(). Handles process management, escaping, timeouts, and errors.
  def powershell_tts(text: str, rate: int = 0, volume: int = 100) -> bool: """PowerShell을 사용한 TTS 실행""" process = None try: if platform.system() != "Windows": safe_print("[ERROR] Windows가 아닙니다") return False # 텍스트에서 작은따옴표 이스케이프 처리 escaped_text = text.replace("'", "''") # PowerShell TTS 명령어 cmd = [ "powershell", "-Command", f"Add-Type -AssemblyName System.Speech; " f"$synth = New-Object System.Speech.Synthesis.SpeechSynthesizer; " f"$synth.Rate = {rate}; " f"$synth.Volume = {volume}; " f"$synth.Speak('{escaped_text}'); " f"$synth.Dispose()" ] # 프로세스 시작 process = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True) # 실행 중인 프로세스 목록에 추가 with process_lock: running_processes.append(process) # 프로세스 완료 대기 stdout, stderr = process.communicate(timeout=180) # 완료된 프로세스 목록에서 제거 with process_lock: if process in running_processes: running_processes.remove(process) if process.returncode == 0: safe_print(f"[SUCCESS] TTS 완료: {text[:30]}...") return True else: safe_print(f"[ERROR] TTS 오류: {stderr}") return False except subprocess.TimeoutExpired: safe_print("[WARNING] TTS 시간 초과") if process: process.kill() with process_lock: if process in running_processes: running_processes.remove(process) return False except Exception as e: safe_print(f"[ERROR] TTS 예외: {e}") if process: try: process.kill() with process_lock: if process in running_processes: running_processes.remove(process) except: pass return False
• windows_tts_mcp/main.py:131-168 (helper)

  Helper function to intelligently split long text into smaller chunks suitable for TTS, prioritizing sentence boundaries.
  def split_text_for_tts(text: str, max_length: int = 500) -> list: """텍스트를 TTS용으로 적절히 분할""" if len(text) <= max_length: return [text] # 문장 단위로 분할 시도 import re sentences = re.split(r'[.!?。！？]\s*', text) chunks = [] current_chunk = "" for sentence in sentences: # 문장이 너무 긴 경우 더 작게 분할 if len(sentence) > max_length: # 쉼표나 기타 구두점으로 분할 sub_parts = re.split(r'[,;:\s]\s*', sentence) for part in sub_parts: if len(current_chunk + part) <= max_length: current_chunk += part + " " else: if current_chunk.strip(): chunks.append(current_chunk.strip()) current_chunk = part + " " else: # 현재 청크에 문장을 추가할 수 있는지 확인 if len(current_chunk + sentence) <= max_length: current_chunk += sentence + ". " else: if current_chunk.strip(): chunks.append(current_chunk.strip()) current_chunk = sentence + ". " # 마지막 청크 추가 if current_chunk.strip(): chunks.append(current_chunk.strip()) return chunks