Vocametrix

@vocametrix/mcp-server

Model Context Protocolの公式サーバーで、Vocametrixの音声分析APIを利用できます。

MCP対応のAIアシスタント（Claude Desktop、Cursor、Clineなど）から、臨床的な音声指標、発音評価、音声の文字起こし、AIを活用したセラピー計画に直接アクセスできます。

クイックスタート

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "vocametrix": {
      "command": "npx",
      "args": ["-y", "@vocametrix/mcp-server"],
      "env": {
        "VOCAMETRIX_API_KEY": "your-api-key-here"
      }
    }
  }
}

APIキーはvocametrix.com/registrationで取得してください。MCPによる分析には購入済みのAPIクレジットが必要です。ウェブサイトのサブスクリプションとトライアルはAPI呼び出しの対象外です。

Claude Code

ホスト型サーバー（ローカルへのインストールは不要）：

claude mcp add --transport http vocametrix https://mcp.vocametrix.com/mcp --header "x-api-key: your-api-key-here"

または、npxを使ってローカルで実行します。

claude mcp add vocametrix -e VOCAMETRIX_API_KEY=your-api-key-here -- npx -y @vocametrix/mcp-server

すべてのプロジェクトでVocametrixを利用できるようにするには、claude mcp addの直後に--scope userを追加します。次に、Claude Codeで/mcpと入力して接続を確認します。

ChatGPT（OAuth、APIクレジット）

オプションの/chatgpt/mcpエンドポイントは、OAuthを通じてユーザーのAPIアカウントを連携します。ユーザーはプラットフォームの同意ページでアクセスを承認します。ChatGPTにはAPIキーではなく、取り消し可能なトークンが渡されます。既存の/mcp APIキーを使うクライアントと、ローカルのstdioクライアントも引き続き利用できます。

対応するプラットフォーム変更、データベースのマイグレーション、設定、テストについては、ChatGPT setup and release checksを参照してください。この連携は、一般公開に先立ちChatGPTにデプロイしてテストする必要があります。

ツール

音声品質（音響）

ツール	説明
vocametrix_calculate_avqi	Acoustic Voice Quality Index（AVQI）— 総合的な嗄声の重症度
vocametrix_calculate_dsi	Dysphonia Severity Index（DSI）
vocametrix_calculate_cpp	ケプストラムピークの顕著度 — 息漏れ声、かすれ声
vocametrix_calculate_hnr	調波対雑音比（マルチバンド）
vocametrix_calculate_jitter_shimmer	周期と振幅の摂動
vocametrix_calculate_voice_range_profile	声域プロファイル
vocametrix_calculate_prosody_similarity	2つの発話間の韻律の類似度

高度な音声分析

ツール	説明
vocametrix_calculate_spectral	スペクトル傾斜、傾き、フォルマントエネルギー
vocametrix_calculate_formants	フォルマント周波数F1–F4
vocametrix_calculate_sz_ratio	S/Z発声比
vocametrix_calculate_gne	声門対雑音励起
vocametrix_calculate_h1_h2	H1–H2の倍音差
vocametrix_calculate_abi	音響的息漏れ指数
vocametrix_calculate_voice_dynamics	ダイナミックレンジと基本周波数の統計
vocametrix_measure_ddk	交互運動（pa-ta-ka）：音節速度、規則性、加速、65～86歳を対象としたPierce 2013の基準値

取り込みユーティリティ

ツール	説明
vocametrix_upload_audio	WAVファイルをアップロード（base64）→ 安定したblobUrlを返します
vocametrix_ingest_url	公開HTTPS WAV URLから取り込み → 安定したblobUrlを返します

音声と言語の発音

ツール	説明
vocametrix_assess_pronunciation	音素レベルの発音スコアリング
vocametrix_assess_pronunciation_with_pitch	発音とピッチの分析を組み合わせて実施
vocametrix_transcribe_audio	進捗を表示するストリーミングASR文字起こし
vocametrix_synthesize_speech	テキスト読み上げ合成

音声指標

ツール	説明
vocametrix_measure_sound_level	時間枠内の未校正 dB での音圧レベル
vocametrix_extract_egemaps	ジュネーブ最小音響パラメータセット、GeMAPS v01b（62 特徴量）
vocametrix_detect_phonemes	信頼度スコアとタイムスタンプ付きのフランス語音素検出
vocametrix_classify_stuttering	非流暢性の分類

AI エージェント

ツール	説明
vocametrix_interpret_voice_metrics	音声指標の臨床的解釈
vocametrix_generate_exercises	個別に最適化した音声・発話エクササイズの生成
vocametrix_generate_word_list	セラピー用の目標単語リストの生成
vocametrix_chat_speech_therapist	会話型の AI 言語聴覚士
vocametrix_convert_french_to_ipa	フランス語テキスト → IPA 音声表記
vocametrix_interpret_spelling_attempt	スペル訂正エージェント
vocametrix_check_syntax	構文チェックエージェント
vocametrix_vocabulary_tutor	語彙学習エージェント
vocametrix_adapt_exercise	適応型エクササイズの生成

セラピー計画

ChatGPT エンドポイント（/chatgpt/mcp）では公開されていません。これらのツールは患者識別子と病歴を受け取るため、ChatGPT アプリのガイドラインでは保護対象の医療情報として扱われます。stdio と /mcp 経由では引き続き利用できます。

ツール	説明
vocametrix_generate_therapy_plan	AI セラピー計画の生成
vocametrix_get_therapy_status	セラピー計画の生成状況の確認
vocametrix_get_therapy_result	完了したセラピー計画の取得
vocametrix_approve_therapy_plan	セラピー計画の承認

ワークフローツール

ツール	説明
vocametrix_full_voice_assessment	AVQI + CPP + HNR + ジッター／シマー + スペクトルを並列に評価
vocametrix_batch_pronunciation	WAV ファイルのフォルダーを評価します。サーバー自身のファイルシステムを読み取るため、stdio／ローカルモード（VOCAMETRIX_MCP_LOCAL_FS=1）でのみ登録され、ホスト型サーバーでは利用できません
vocametrix_full_therapy_workflow	生成 → 状況確認 → 取得 → 承認のフロー

リソース

• vocametrix://docs/api — API クイックリファレンス（認証、レート制限、音声要件、エラーコード）
• vocametrix://recording-guide — すべてのツールの録音プロトコル（持続母音、言語別の参照文を用いた連続発話、グリッサンド、持続する /s/ と /z/）
• vocametrix://thresholds/{metric} — avqi、dsi、cpp、hnr、jitter-shimmer、gne の臨床参照閾値

プロンプト

• interpret_voice_assessment — 評価 JSON から、臨床的な言語聴覚士形式の解釈レポートを生成
• compare_pre_post_therapy — 指標ごとの比較を含む、定量的なセラピー前後の記述
• generate_session_report — 発音評価データから SOAP 形式の経過記録を生成

音声要件

• 形式：WAV（16-bit PCM を推奨）
• 持続母音タスク：/a/ の発声を 3 秒以上
• 連続発話タスク：朗読文を 5～30 秒
• 最小サンプリングレート：16 kHz

ツールに音声を渡す方法

audioPath パラメーターは複数の入力形式を受け付けますが、有効な形式は MCP サーバーの実行方法によって異なります。

入力	ホスト型／リモートサーバー	Stdio／ローカルサーバー（npx、Claude Desktop）
vocametrix_upload_audio の https://... の blobUrl	✅ 推奨	✅
WAV ファイルへの公開 https://... URL	✅	✅
vocametrix_ingest_url 経由の公開 URL → 返された blobUrl	✅ URL 入力に推奨	✅
data:audio/wav;base64,... データ URL	✅	✅
生の base64 文字列（512 文字以上）	✅	✅
絶対ローカルパス（/home/...、C:\...）	❌ 拒否されます	⚠️ VOCAMETRIX_MCP_LOCAL_FS=1 が必要です

会話に音声を添付するチャットクライアント（Claude.ai のウェブ版／モバイル版など）の場合、LLM はホスト型サーバーに絶対パスを渡せません。まずファイルの内容を base64 エンコードして vocametrix_upload_audio を呼び出し、返された blobUrl を audioPath として任意の分析ツールに渡す必要があります。MCP の説明により、LLM はこのワークフローに自動的に誘導されます。

MCP がユーザー自身のマシン上で実行される Stdio／ローカル環境の場合、VOCAMETRIX_MCP_LOCAL_FS=1 を設定すると、分析ツールが絶対ローカルパスを直接読み取れるようになります。すでにディスク上にあるファイルを一括処理する場合に便利です。

環境変数

変数	必須	説明
VOCAMETRIX_API_KEY	はい	Vocametrix API キー
VOCAMETRIX_MCP_LOCAL_FS	いいえ	1 を設定すると、分析ツールが絶対ローカルファイルパスを読み取れるようになります（Stdio／ローカル環境のみ）。デフォルトではオフです。ローカルパスは、チャットクライアントが vocametrix_upload_audio → blobUrl のワークフローを使うよう促す、実行可能な対処法を示すエラーとともに拒否されます。
VOCAMETRIX_MCP_ALLOW_PRIVATE_HOSTS	いいえ	1 を設定すると、ホストがプライベートアドレス、ループバックアドレス、またはリンクローカルアドレスに解決される音声 URL の取得が許可されます（たとえば LAN ファイルサーバー）。Stdio／ローカルモードでもデフォルトではオフです。MCP ツールの呼び出し元は LLM であり、悪意のあるページを読み込んだ LLM は、これらのツールをユーザー自身のネットワークに向けるよう誘導される可能性があるためです。

開発

git clone https://github.com/Vocametrix/vocametrix-mcp.git
cd vocametrix-mcp
npm install
npm run build
npm test            # run unit tests
npm run inspector   # test with MCP Inspector

MCP Registry

io.github.pmarmaroli/vocametrix-mcp として公式の MCP Registry に掲載されています。MCP 対応クライアント（Claude Desktop、Cursor、Zed、Windsurf など）でワンクリックインストールを利用できます。

関連プロジェクト

Vocametrix エコシステム：

• 📘 Vocametrix API ドキュメント — この MCP サーバーを支える REST API の完全なリファレンスです。
• 📐 OpenAPI 3.1 仕様 — 49 個すべてのエンドポイントの機械可読スキーマです。
• 🐍 vocametrix-python — Python から API に直接アクセスする場合に利用できる公式 Python SDK です（pip install vocametrix）。
• 🟦 vocametrix-js — この MCP サーバーで内部的に使用されている公式 TypeScript／JavaScript SDK です（npm install vocametrix）。

ライセンス

MIT — LICENSE を参照してください。