Ms Lucidia Voice Gateway MCP

🚀 MS-Lucidia-Voice-Gateway-MCP

MS-Lucidia-Voice-Gateway-MCP 是一個模型上下文協議（MCP）服務器，它藉助 Windows 內置語音服務，提供文字轉語音（TTS）和語音轉文字（STT）功能。該服務器通過 PowerShell 命令調用本地 Windows 語音 API（SAPI），無需依賴外部 API 或服務，使用起來更加便捷和安全。

🚀 快速開始

先決條件

• Windows 10/11，啟⽤語⾳識別
• Node.js 16+
• PowerShell

安裝步驟

1. 克隆倉庫：

git clone https://github.com/ExpressionsBot/MS-Lucidia-Voice-Gateway-MCP.git
cd MS-Lucidia-Voice-Gateway-MCP

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

使用說明

測試界⾯

1. 啟動測試服務器：

npm run test

2. 打開 http://localhost:3000 在瀏覽器中
3. 使用網頁界⾯測試 TTS 和 STT 功能

可⽤⼯具

text_to_speech

⽤ Windows SAPI 語⾳將⽂字轉為語⾔。

參數：

• text（必需）：要轉換的⽂字
• voice（可選）：要使⽤的語⾳（例如，“Microsoft David Desktop”）
• speed（可選）：語⾔速度，範圍 0.5 到 2.0（默認：1.0）

例：

fetch('http://localhost:3000/tts', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    text: "Hello, this is a test",
    voice: "Microsoft David Desktop",
    speed: 1.0
  })
});

speech_to_text

記錄⾳頻並將其轉換為⽂字，使⽤ Windows 語⾔識別。

參數：

• duration（可選）：錄製時⻓（秒，默認：5，最⼤：60）

例：

fetch('http://localhost:3000/stt', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    duration: 5
  })
}).then(response => response.json())
  .then(data => console.log(data.text));

✨ 主要特性

• 使用 Windows SAPI 語⾳的⽂字轉語⾔（TTS）
• 使用 Windows 語⾔識別（SR）的語⾔轉⽂字（STT）
• 簡單的網頁界面⽤於測試
• 無外部 API 依賴
• 利⽤本地 Windows 功能

🔧 故障排除

1. 確保 Windows 語⾔識別已啟⽤：

   • 打開 Windows 設置
   • 進⼊時間和語言 > 語⾳
   • 啟⽤語⾔識別

2. 檢查可⽤的語⾳：

   • 打開 PowerShell 並運⾏：

   Add-Type -AssemblyName System.Speech
   (New-Object System.Speech.Synthesis.SpeechSynthesizer).GetInstalledVoices().VoiceInfo.Name
   

3. 測試語⾔識別：

   • 在 Windows 設置中打開語⾔識別
   • 如果尚未完成，請完成安裝嚮導
   • 測試 Windows 是否能識別您的語⾳

🤝 貢獻

1. 叉克隆倉庫
2. 創建功能分支
3. 提交更改
4. 推送到分支
5. 創建新的 Pull Request

📄 許可證

MIT