Edge Tts MCP Server

🚀 Edge-TTS MCP 服務器

本項目是一個基於 Model Context Protocol (MCP) 的服務器，藉助 Microsoft Edge 的文本朗讀功能，通過 AI 代理提供強大的語音合成服務，為用戶帶來自然流暢的語音交互體驗。

🚀 快速開始

此 MCP 服務器利用 edge-tts 庫，提供從文本到語音的轉換功能，旨在讓 AI 代理能夠以自然的聲音進行響應。

✨ 主要特性

• 支持文本到語音轉換，輕鬆將文字轉化為生動語音。
• 提供多種聲音和語言選擇，滿足不同場景和用戶的多樣化需求。
• 可靈活調節音速和音高，讓語音表達更符合實際需求。
• 支持音頻數據流媒體，實現流暢的音頻播放體驗。

📦 安裝指南

常規安裝

pip install "edge_tts_mcp_server"

開發模式安裝

git clone https://github.com/yuiseki/edge_tts_mcp_server.git
cd edge_tts_mcp_server
pip install -e .

💻 使用示例

VS Code 配置示例

在 VS Code 的 settings.json 中配置的示例：

"mcp": {
  "servers": {
    "edge-tts": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\__username__\\src\\edge_tts_mcp_server\\src\\edge_tts_mcp_server",
        "run",
        "server.py"
      ]
    }
  }
}

MCP Inspector 使用

作為標準的 MCP 服務器運行：

mcp dev server.py

uvicorn 運行

以 FastAPI 基礎的服務器使用 uv 運行時：

uv --directory path/to/edge_tts_mcp_server/src/edge_tts_mcp_server run server.py

命令行選項

edge-tts-mcp --host 0.0.0.0 --port 8080 --reload

📚 詳細文檔

API 端點

以 FastAPI 模式運行時，可以使用以下端點：

• / - API 信息
• /health - 健康檢查
• /voices - 可用聲音列表（可選參數：?locale=ja-JP 進行篩選）
• /mcp - MCP API 端點

📄 許可證

本項目採用 MIT 許可證。