Windows Tts MCP

🚀 Windows TTS MCP 服務器

Windows TTS MCP 服務器是一款專為 Claude Desktop 打造的文本轉語音（TTS）服務器，藉助 Windows 的內置語音 API，通過 PowerShell 實現穩定且高效的 TTS 功能，能將文本快速準確地轉換為語音。

🚀 快速開始

Windows TTS MCP 服務器利用 Windows 的內置 Speech API，通過 PowerShell 提供穩定且快速的 TTS 功能。以下是基本使用步驟：

1. 安裝服務器（具體安裝方法見下方“📦 安裝指南”）。
2. 配置 Claude Desktop（具體配置方法見下方“🎛️ Claude Desktop 配置”）。
3. 在 Claude Desktop 中發起語音轉換請求（具體使用方法見下方“💻 使用示例”）。

✨ 主要特性

• 🎵 穩定的 TTS：基於 Windows PowerShell 構建，確保線程安全，提供穩定的語音合成服務。
• ⚡ 快速響應：支持後臺播放，實現即時響應，讓您無需等待。
• 🎛️ 多樣選項：可靈活調節語音的速度和音量，滿足不同場景需求。
• ⏹️ 完全控制：支持暫停語音播放、強制終止所有 TTS 進程以及查看播放狀態。
• 🚨 緊急功能：具備系統全局靜音功能，應對突發情況。
• 📦 便捷安裝：通過 uvx 實現一鍵安裝和運行，操作簡單。

📦 安裝指南

通過 uvx 運行（推薦）

# 運行軟件包
uvx windows-tts-mcp

# 開發模式
uvx --from . tts-dev

# 未來支持從 GitHub 直接運行
uvx --from git+https://github.com/yourusername/windows-tts-mcp windows-tts-mcp

本地開發

# 克隆倉庫
git clone https://github.com/yourusername/windows-tts-mcp
cd windows-tts-mcp

# 本地運行
uvx --from . windows-tts-mcp

# 開發模式
uvx --from . tts-dev

🎛️ Claude Desktop 配置

在 Claude Desktop 的配置文件中添加以下內容：

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

配置文件位置：

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

💻 使用示例

基礎用法

在 Claude Desktop 中，您可以通過以下方式發起語音轉換請求：

• 基本語音播放：發送 "這文本讀一下" 等指令。
• 速度調節：發送 "快速讀：[文本]" 或 "慢速讀：[文本]" 等指令。
• 音量調節：發送 "小聲讀：[文本]" 等指令。
• 播放控制：發送 "停止語音" 可暫停播放；發送 "查看語音狀態" 可查看播放狀態；發送 "強制終止所有語音" 可終止所有 TTS 進程；發送 "緊急靜音" 可全局靜音。

高級用法

除了上述基本用法，您還可以使用以下工具進行更精細的控制：

🔧 技術細節

系統要求

• 操作系統：Windows 10/11
• Python：3.11 及以上版本
• PowerShell：5.0 及以上版本（Windows 系統默認安裝）
• 其他：Windows Speech Platform（系統默認安裝）

架構

Claude Desktop
    ↓ (MCP 協議)
Windows TTS MCP 服務器
    ↓ (子進程)
PowerShell
    ↓ (System.Speech)
Windows 語音 API
    ↓
音頻輸出

特點

• 線程安全：每個 TTS 請求都在單獨的線程中處理，確保系統穩定性。
• 進程管理：實時跟蹤和控制所有正在運行的 TTS 進程。
• 錯誤處理：具備完善的錯誤處理機制，能有效應對超時和異常情況。
• 資源清理：自動清理已完成的進程，釋放系統資源。

🐛 問題解決

沒有聲音輸出

1. 檢查 Windows 音頻

# 在 PowerShell 中直接測試
Add-Type -AssemblyName System.Speech
$synth = New-Object System.Speech.Synthesis.SpeechSynthesizer
$synth.Speak("測試")

2. 檢查音量設置
   • 在 Windows 音量混合器中檢查 PowerShell 的音量。
   • 確認系統默認音頻設備的設置。
3. 檢查語音平臺
   • 打開 Windows 設置 → 時間和語言 → 語音。
   • 確認語音識別語言的設置。

進程殘留

# 強制清理
uvx windows-tts-mcp
# 在 Claude 中執行 "強制終止所有 TTS"

📝 開發

項目結構

windows-tts-mcp/
├── pyproject.toml          # 軟件包配置
├── README.md               # 本文件
├── windows_tts_mcp/        # 主軟件包
│   ├── __init__.py
│   └── main.py            # TTS 服務器代碼
├── .gitignore
└── uv.lock

開發環境設置

# 克隆倉庫
git clone https://github.com/yourusername/windows-tts-mcp
cd windows-tts-mcp

# 使用 uv 安裝依賴
uv sync

# 以開發模式運行
uvx --from . tts-dev

貢獻代碼

1. Fork 此倉庫。
2. 創建新分支 (git checkout -b feature/amazing-feature)。
3. 提交更改 (git commit -m '添加出色的功能')。
4. 將分支推送到遠程倉庫 (git push origin feature/amazing-feature)。
5. 提交 Pull Request。

📄 許可證

本項目遵循 MIT 許可證。詳情請參閱 LICENSE 文件。

🙏 致謝

• Anthropic - 開發了 Claude 和 MCP。
• Model Context Protocol - 提供了 MCP 標準。
• uv - 現代 Python 軟件包管理工具。

🔗 相關鏈接

• Model Context Protocol 官方文檔
• Claude Desktop 下載
• uv 官方文檔

為 Claude Desktop 用戶用心打造 ❤️