Windows Tts MCP

🚀 Windows TTS MCP Server

Windows TTS MCP Serverは、Claude Desktop用のWindows PowerShellベースのText-to-Speechサーバーです。このサーバーは、Claude Desktop内でテキストを音声に変換する機能を提供し、Windowsの組み込みSpeech APIをPowerShellを通じて活用することで、安定的かつ高速なTTS機能を実現します。

🚀 クイックスタート

Windows TTS MCP Serverは、Claude Desktopでテキストを音声に変換するMCP(Model Context Protocol)サーバーです。Windowsの組み込みSpeech APIをPowerShellを通じて利用し、安定的で高速なTTS機能を提供します。

✨ 主な機能

• 🎵 安定したTTS: Windows PowerShellベースでスレッドセーフ性を確保
• ⚡ 高速応答: バックグラウンド再生により即座に応答
• 🎛️ 多様なオプション: 速度、音量の調整が可能
• ⏹️ 完全な制御: 再生の停止、強制終了、状態の確認
• 🚨 緊急機能: システム全体のミュート
• 📦 簡単なインストール: 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の状態を確認してください"
- "すべての音声を強制終了してください"
- "緊急ミュートしてください" (システム全体のミュート)

ツール一覧

🔧 技術詳細

システム要件

アーキテクチャ

Claude Desktop
    ↓ (MCP Protocol)
Windows TTS MCP Server
    ↓ (サブプロセス)
PowerShell
    ↓ (System.Speech)
Windows Speech API
    ↓
オーディオ出力

特徴

• スレッドセーフ性: 各TTSリクエストを別々のスレッドで処理
• プロセス管理: 実行中のすべてのTTSプロセスを追跡して制御
• エラー処理: タイムアウトや例外状況に対する堅牢な処理
• リソースクリーンアップ: 完了したプロセスを自動的にクリーンアップ

📚 トラブルシューティング

音声が出ない場合

1. Windowsオーディオの確認

# PowerShellで直接テスト
Add-Type -AssemblyName System.Speech
$synth = New-Object System.Speech.Synthesis.SpeechSynthesizer
$synth.Speak("テスト")

2. 音量設定の確認
   • Windowsの音量ミキサーでPowerShellの音量を確認
   • システムのデフォルトオーディオデバイス設定を確認
3. Speech Platformの確認
   • 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. このリポジトリをフォークしてください。
2. 新しいブランチを作成してください (git checkout -b feature/amazing-feature)。
3. 変更をコミットしてください (git commit -m 'Add amazing feature')。
4. ブランチにプッシュしてください (git push origin feature/amazing-feature)。
5. プルリクエストを作成してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で配布されています。詳細については、LICENSEファイルを参照してください。

🙏 謝辞

• Anthropic - ClaudeとMCPの開発
• Model Context Protocol - MCP標準の提供
• uv - 最新のPythonパッケージ管理

🔗 関連リンク

• Model Context Protocol公式ドキュメント
• Claude Desktopダウンロード
• uv公式ドキュメント

Made with ❤️ for Claude Desktop users