README.md•2.06 kB
# Edge-TTS MCP Server
Model Context Protocol (MCP) サーバーで、Microsoft Edge のテキスト読み上げ機能を活用した AI エージェントの音声合成サービスを提供します。
## 概要
この MCP サーバーは、[edge-tts](https://github.com/rany2/edge-tts)ライブラリを使用して、テキストから音声への変換機能を提供します。AI エージェントが自然な音声で応答できるようにするためのツールとして設計されています。
## 機能
- テキストから音声への変換
- 複数の音声と言語のサポート
- 音声速度と音程の調整
- 音声データのストリーミング
## インストール
```bash
pip install "edge_tts_mcp_server"
```
または開発モードでインストールする場合：
```bash
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 で設定する例：
```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 サーバーとして実行：
```bash
mcp dev server.py
```
### uvx（uvicorn）での実行
FastAPI ベースのサーバーとして uv で実行する場合：
```bash
uv --directory path/to/edge_tts_mcp_server/src/edge_tts_mcp_server run server.py
```
コマンドラインオプション：
```bash
edge-tts-mcp --host 0.0.0.0 --port 8080 --reload
```
## API エンドポイント
FastAPI モードで実行した場合、以下のエンドポイントが利用可能です：
- `/` - API 情報
- `/health` - ヘルスチェック
- `/voices` - 利用可能な音声一覧（オプションで `?locale=ja-JP` などでフィルタリング可能）
- `/mcp` - MCP API エンドポイント
## ライセンス
MIT