Skip to main content
Glama

音声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
      }
    }
  }
}

Related MCP server: TTS-MCP

特徴

  • 🎯 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モデルのダウンロードと初期化を試みます。初期化エラーが発生した場合は、以下の手順に従ってください。

  1. サーバーは、試行の間にクリーンアップを行いながら、最大3回まで自動的に再試行します。

  2. get_model_statusツールを使用して、初期化の進行状況とエラーを監視します。

  3. すべての再試行後も初期化が失敗した場合は、モデル ファイルを手動で削除してみてください。

# 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)"
  }]
}

Available Tools

4 tools
get_model_statusB

Get the current status of the TTS model initialization

Inputs: no named parameters.

list_voicesB

List all available voices for text-to-speech

Inputs: no named parameters.

text_to_speechB

Convert text to speech and play it through system audio

Inputs: text (required), voice.

text_to_speech_with_optionsC

Convert text to speech with customizable speed

Inputs: text (required), voice, speed.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 4 tools

    Disambiguation4/5

    The tools are mostly distinct, but 'text_to_speech' and 'text_to_speech_with_options' could cause confusion as they overlap in core functionality. The other tools ('get_model_status' and 'list_voices') have clear, unique purposes related to system status and voice selection.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with clear verb_noun structures (e.g., 'get_model_status', 'list_voices', 'text_to_speech'). There are no deviations in naming conventions across the set.

    Tool Count4/5

    Four tools is a reasonable count for a speech-focused server, though it feels slightly minimal. The tools cover key aspects like status, voice listing, and speech generation, but could potentially benefit from one or two more operations (e.g., stop speech or adjust volume) for better scope.

    Completeness3/5

    The server provides core text-to-speech functionality with status and voice listing, but lacks operations for managing speech playback (e.g., pause, stop, or volume control) and advanced customization beyond speed. This creates minor gaps that agents might need to work around for full speech interaction.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that integrates high-quality text-to-speech capabilities with Claude Desktop and other MCP-compatible clients, supporting multiple voice options and audio formats.
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that provides text-to-speech functionality for AI agents using Microsoft Edge's text-to-speech technology, supporting multiple voices, languages, and voice customization.
      2
      8
      MIT