Speech MCP Server
音声MCPサーバー
Kokoro TTS モデルを使用してテキスト読み上げ機能を提供するモデル コンテキスト プロトコル サーバー。
構成
サーバーは次の環境変数を使用して構成できます。
変数 | 説明 | デフォルト | 有効範囲 |
| テキスト読み上げのデフォルトの速度乗数 | 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.jsClaude 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 startget_model_statusツールの応答に再試行情報が含まれるようになりました。
{
"content": [{
"type": "text",
"text": "Model status: initializing (5s elapsed, retry 1/3)"
}]
}Available Tools
4 toolsget_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
Scored across 4 tools
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.
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.
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.
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
Related MCP Connectors
Hosted text-to-speech MCP server: 66 voices in 9 languages, long-form narration, podcasts.
Remote text-to-speech MCP server with text_to_speech and list_voices tools. Free plan.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for Text-to-Speech
Related MCP Servers
- AlicenseDqualityDmaintenanceA Model Context Protocol server that enables AI assistants to utilize AivisSpeech Engine's high-quality voice synthesis capabilities through a standardized API interface.11ISC
- AlicenseNot gradedqualityDmaintenanceA 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.1MIT
- AlicenseBqualityDmaintenanceA 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.28MIT
- AlicenseDqualityDmaintenanceA Model Context Protocol server that integrates with VOICEVOX engine to provide text-to-speech synthesis and speaker information retrieval, allowing users to generate and play voice audio from text.2MIT
Appeared in Searches
- A platform providing TTS (Text-to-Speech) capabilities
- A service to convert text to ready-to-use audio with download, player, or embed options
- Using Hugging Face for Text-to-Audio, Image, and Video Generation
- A search for translation services or tools
- A system for retrieving medical knowledge, especially in medical imaging, and generating reports