MCP Tts Server

🚀 MCP 文本轉語音服務器

MCP 文本轉語音服務器是一款功能多樣的文本轉語音（TTS）服務器，基於模型上下文協議（MCP）框架構建。它通過統一接口，讓用戶能夠訪問多種 TTS 引擎，為用戶提供了便捷且豐富的語音合成體驗。

🚀 快速開始

MCP 文本轉語音服務器能通過統一接口訪問多種 TTS 引擎，使用前需完成安裝與配置。

先決條件

• Python 3.10 或更高版本
• uv 包管理器
• 有效的 OpenAI API 密鑰（適用於 OpenAI TTS）

安裝步驟

1. 使用以下命令克隆倉庫：

git clone https://github.com/your-repository.git
cd your-repository

2. 安裝依賴項：

pip install -r requirements.txt

3. 根據需要配置 .env 文件，如下所示：

OPENAI_API_KEY=your_api_key_here

4. 啟動服務器：

uv run python tts_mcp.py

配置說明

• 將 your_api_key_here 替換為實際的 OpenAI API 密鑰
• 確保 Python 環境滿足最低版本要求（3.10+）

✨ 主要特性

• 🌐 多種 TTS 引擎統一在一個服務器中
• 🎧 即時音頻流播放
• 🔄 MCP 協議支持，與 Claude 和其他 LLM 無縫集成
• 🎛️ 可配置的語音選擇（適用於兩種引擎）
• 💬 通過自然語言指令實現聲音定製（OpenAI）
• ⚡ 調整播放速度（適用於兩種引擎）
• 🛑 播放控制，支持停止音頻和清空隊列

📦 安裝指南

先決條件

• Python 3.10 或更高版本
• uv 包管理器
• 有效的 OpenAI API 密鑰（適用於 OpenAI TTS）

安裝步驟

1. 使用以下命令克隆倉庫：

git clone https://github.com/your-repository.git
cd your-repository

2. 安裝依賴項：

pip install -r requirements.txt

3. 根據需要配置 .env 文件，如下所示：

OPENAI_API_KEY=your_api_key_here

4. 啟動服務器：

uv run python tts_mcp.py

💻 使用示例

啟動服務器

# 使用uv運行環境管理器啟動
uv run python tts_mcp.py

# 或者使用簡化的Kokoro-only版本
uv run python simple_tts_mcp.py

此命令將啟動 MCP 服務器，使其可供連接和使用。

📚 詳細文檔

與 Claude Desktop 集成

此服務器設計用於與 Claude Desktop 或其他支持 MCP 協議的應用程序協同工作。無需額外配置即可直接使用。

MCP 函數定義

tts_mcp.py

tts_main()

• 接受輸入參數：text（要轉換的文本）、voice（選擇語音，默認為 "default"）
• 支持以下命令參數：
  • --af-synthesis: 使用文件生成語音
  • --stream: 啟用音頻流播放

tts_streaming()

• 實現了基於 OpenAI 的即時 TTS 功能，支持多種語言和語音風格。

可用語音

Kokoro TTS

• 默認語音：af_heart

OpenAI TTS

• 可用語音：alloy, ash, ballad, coral, echo, fable, onyx, nova, sage, shimmer
• 默認模型：gpt-4o-mini-tts

開發與測試

本地調試

fastmcp dev ./tts_mcp.py

此命令啟動 MCP Inspector 界面，方便開發者測試服務器功能。

故障排除

遇到問題時，請參考以下常見解決方案：

1. 無音頻輸出：檢查系統音頻配置
2. OpenAI TTS 失敗：確認 API 密鑰有效且具有 TTS 權限
3. 服務器未找到：確保 MCP 服務器已正確註冊在您的 MCP 宿主中

📄 許可證

此項目遵循 Apache License 2.0 協議，具體條款請參閱 LICENSE 文件。

貢獻指南

歡迎貢獻！請隨意提交 Pull Request。