🚀 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 许可证。