JinDaGe - edge_tts_mcp_server MCP Details

article

README

🚀 Edge-TTS MCP 服务器

Edge-TTS MCP 服务器借助 Microsoft Edge 的文本朗读功能，通过 AI 代理提供音声合成服务。它基于 Model Context Protocol (MCP)，能实现文本到语音的自然转换，为 AI 交互增添生动性。

🚀 快速开始

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

edge_tts_mcp_server