---
title: Edge-TTS-MCP-Server
canonical_url: "https://www.modelscope.cn/studios/redstoneleo/Edge-TTS-MCP-Server"
md_url: "https://www.modelscope.cn/studios/redstoneleo/Edge-TTS-MCP-Server.md"
repository: redstoneleo/Edge-TTS-MCP-Server
chinese_name: "微软线上 Edge TTS & MCP | MCP&Agent挑战赛"
last_updated: 2025-08-29
sdk_type: gradio
sdk_version: 5.42.0
downloads: 0
stars: 4
---

# Edge-TTS-MCP-Server

> Edge-TTS-MCP-Server - redstoneleo 在 ModelScope 创建的在线 Demo。微软免费文本语音合成，基于Edge TTS。可在线使用 https://modelscope.cn/studios/redstoneleo/Edge-TTS-MCP-Server

redstoneleo/Edge-TTS-MCP-Server 是 ModelScope 魔搭社区上的在线可交互 Demo（创空间），基于 gradio 5.42.0 构建，中文名为「微软线上 Edge TTS & MCP | MCP&Agent挑战赛」。

- **Repository**: redstoneleo/Edge-TTS-MCP-Server
- **SDK**: gradio
- **SDK version**: 5.42.0
- **Downloads**: 0
- **Stars**: 4
- **Last updated**: 2025-08-29

Source: https://www.modelscope.cn/studios/redstoneleo/Edge-TTS-MCP-Server

---

# Microsoft Online Edge TTS & MCP Server

A Model Context Protocol server that enables LLMs to convert text to speech using the free [Microsoft Edge TTS](https://github.com/rany2/edge-tts), API and MCP are available. 
### Online Tool & Demo
https://huggingface.co/spaces/redstoneleo/Edge-TTS-MCP-Server
### Available Tools


-   `list_voices` – Fetches the available voices from Microsoft Edge TTS.
    
    -   **Returns** (object): A dictionary mapping **display names** (e.g., `"en-US-JennyNeural - Female"`) to their corresponding voice metadata, in the form:
        
        ```json
        {
          "Name": "Microsoft Server Speech Text to Speech Voice (zh-CN, XiaoxiaoNeural)",
          "ShortName": "zh-CN-XiaoxiaoNeural",
          "Gender": "Female",
          "Locale": "zh-CN",
          "SuggestedCodec": "audio-24khz-48kbitrate-mono-mp3",
          "FriendlyName": "Microsoft Xiaoxiao Online (Natural) - Chinese (Mainland)",
          "Status": "GA",
          "VoiceTag": {
            "ContentCategories": ["News", "Novel"],
            "VoicePersonalities": ["Warm"]
          }
        }
        
        ```
        


-   `text_to_speech` – Converts input text into speech audio using Microsoft Edge TTS.
    
    -   `text` (string, required): The text content to be synthesized into speech.
        
    -   `voice` (string, required): The selected voice in the format `"ShortName - Gender"`.
        
    -   `rate` (integer, optional): Speech rate adjustment percentage (e.g., `-20%` for slower, `+20%` for faster). Default: `0` means `+0%`.
        
    -   `pitch` (integer, optional): Pitch adjustment in Hz. Default: `0` means `+0Hz`.
        
    -   **Returns** (string): URL to the generated MP3 file.
        


### Prompts

- **list_voices**
  - list all available voice display names

- **text_to_speech**
  - TTS `<your text>` with a proper voice

## Installation and Configuration

 1. ```pip install edge_tts gradio -U``` 
 2. Download `app.py`.
 3. Run  ```python app.py```, then the console will show information
    like this
    
	    * Running on local URL:  http://127.0.0.1:7860
	    * To create a public link, set `share=True` in `launch()`.
	    
	    🔨 Launching MCP server:
	    ** Streamable HTTP URL: http://127.0.0.1:7860/gradio_api/mcp/
	    * [Deprecated] SSE URL: http://127.0.0.1:7860/gradio_api/mcp/sse

You can find the exact config to copy-paste by visiting the  local URL and going to the "Use via API or MCP" link in the footer of your Gradio app, and then clicking on "MCP".
![enter image description here](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/gradio-guides/view-api-mcp.png)
For clients that support SSE (e.g. Cursor, Windsurf, Cline), simply add the following configuration to your MCP config, for detailed steps please refer [here](https://www.gradio.app/guides/using-docs-mcp#installing-in-the-clients).
```json
{
  "mcpServers": {
    "Edge TTS": {
      "url": "http://127.0.0.1:7860/gradio_api/mcp/"
    }
  }
}
```


## License

Edge TTS MCP Server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.