音声MCPサーバー

Kokoro TTS モデルを使用してテキスト読み上げ機能を提供するモデルコンテキストプロトコルサーバー。

構成

サーバーは次の環境変数を使用して構成できます。

変数	説明	デフォルト	有効範囲
`MCP_DEFAULT_SPEECH_SPEED`	テキスト読み上げのデフォルトの速度乗数	1.1	0.5から2.0

カーソル内:

{
  "mcpServers": {
    "speech": {
      "command": "npx",
      "args": [
        "-y",
        "speech-mcp-server"
      ],
      "env": {
        MCP_DEFAULT_SPEECH_SPEED: 1.3
      }
    }
  }
}

特徴

🎯 Kokoro TTS モデルを使用した高品質のテキスト読み上げ
🗣️ 複数の音声オプションが利用可能
🎛️ カスタマイズ可能な音声パラメータ（音声、速度）
🔌 MCP準拠インターフェース
📦 簡単なインストールとセットアップ
🚀 APIキーは不要です

インストール

# Using npm
npm install speech-mcp-server

# Using pnpm (recommended)
pnpm add speech-mcp-server

# Using yarn
yarn add speech-mcp-server

使用法

サーバーを実行します。

# Using default configuration
npm start

# With custom speech speed
MCP_DEFAULT_SPEECH_SPEED=1.5 npm start

サーバーは次の MCP ツールを提供します。

text_to_speech : 基本的なテキスト読み上げ変換
text_to_speech_with_options : 速度をカスタマイズできるテキスト読み上げ
list_voices : 利用可能なすべての音声を一覧表示する
get_model_status : TTSモデルの初期化ステータスを確認する

発達

# Clone the repository
git clone <your-repo-url>
cd speech-mcp-server

# Install dependencies
pnpm install

# Start development server with auto-reload
pnpm dev

# Build the project
pnpm build

# Run linting
pnpm lint

# Format code
pnpm format

# Test with MCP Inspector
pnpm inspector

利用可能なツール

1. テキスト読み上げ

デフォルト設定を使用してテキストを音声に変換します。

{
  "type": "request",
  "id": "1",
  "method": "call_tool",
  "params": {
    "name": "text_to_speech",
    "arguments": {
      "text": "Hello world",
      "voice": "af_bella"  // optional
    }
  }
}

2. オプション付きテキスト読み上げ

カスタマイズ可能なパラメータを使用してテキストを音声に変換します。

{
  "type": "request",
  "id": "1",
  "method": "call_tool",
  "params": {
    "name": "text_to_speech_with_options",
    "arguments": {
      "text": "Hello world",
      "voice": "af_bella",  // optional
      "speed": 1.0,         // optional (0.5 to 2.0)
    }
  }
}

3. リストボイス

テキスト読み上げに使用できるすべての音声を一覧表示します。

{
  "type": "request",
  "id": "1",
  "method": "list_voices",
  "params": {}
}

4. get_model_status

TTSモデルの初期化の現在のステータスを確認します。モデルをダウンロードして初期化する必要があるため、サーバーの初回起動時に特に便利です。

{
  "type": "request",
  "id": "1",
  "method": "call_tool",
  "params": {
    "name": "get_model_status",
    "arguments": {}
  }
}

応答例:

{
  "content": [{
    "type": "text",
    "text": "Model status: initializing (5s elapsed)"
  }]
}

可能なステータス値:

uninitialized : モデルの初期化が開始されていません
initializing : モデルをダウンロードして初期化しています
ready : モデルは使用可能です
error : 初期化中にエラーが発生しました

テスト

MCP Inspector を使用するか、生の JSON メッセージを送信してサーバーをテストできます。

# List available tools
echo '{"type":"request","id":"1","method":"list_tools","params":{}}' | node dist/index.js

# List available voices
echo '{"type":"request","id":"2","method":"list_voices","params":{}}' | node dist/index.js

# Convert text to speech
echo '{"type":"request","id":"3","method":"call_tool","params":{"name":"text_to_speech","arguments":{"text":"Hello world","voice":"af_bella"}}}' | node dist/index.js

Claude Desktopとの統合

このサーバーを Claude Desktop で使用するには、Claude Desktop 構成ファイル ( ~/Library/Application Support/Claude/claude_desktop_config.json ) に次の行を追加します。

{
  "servers": {
    "speech": {
      "command": "npx",
      "args": ["@decodershq/speech-mcp-server"]
    }
  }
}

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

MIT ライセンス - 詳細についてはLICENSEファイルを参照してください。

トラブルシューティング

モデルの初期化の問題

サーバーは起動時に自動的にTTSモデルのダウンロードと初期化を試みます。初期化エラーが発生した場合は、以下の手順に従ってください。

サーバーは、試行の間にクリーンアップを行いながら、最大3回まで自動的に再試行します。
get_model_statusツールを使用して、初期化の進行状況とエラーを監視します。
すべての再試行後も初期化が失敗した場合は、モデルファイルを手動で削除してみてください。

# Remove model files (MacOS/Linux)
rm -rf ~/.npm/_npx/**/node_modules/@huggingface/transformers/.cache/onnx-community/Kokoro-82M-v1.0-ONNX/onnx/model_quantized.onnx
rm -rf ~/.cache/huggingface/transformers/onnx-community/Kokoro-82M-v1.0-ONNX/onnx/model_quantized.onnx

# Then restart the server
npm start

get_model_statusツールの応答に再試行情報が含まれるようになりました。

{
  "content": [{
    "type": "text",
    "text": "Model status: initializing (5s elapsed, retry 1/3)"
  }]
}

Speech MCP Server

Integrations