Parlova

Parlova MCP：Claude、Cursor、VS Code から音声、動画、YouTube を文字起こし

Parlova を使うと、AI アシスタントでローカルの録音や YouTube 動画を、話者ラベル付きの正確なタイムスタンプ入り文字起こしに変換できます。チャットから離れずに、内容を要約、検索、引用できます。

ローカルの MCP サーバー（parlova mcp）として動作し、90 以上の言語と自動検出に対応する Parlova の文字起こし API と通信します。アフリカーンス語や isiZulu にも対応し、1 つの録音内で言語が混在している場合も認識できます。便利なコマンドラインツールとしても使えます。

前提条件

• Python 3.8 以降。依存関係はなく、標準ライブラリのみを使用する単一ファイルです。
• Parlova の Plus（月額 $5）または Pro（月額 $10）アカウント。開発者向けアクセス（API、CLI、MCP）は Free プランでは利用できません。 まずはウェブ上で無料の品質をお試しください。

クイックスタート（約 1 分）

1. インストール（いずれかを選択）

uv tool install parlova          # or: pipx install parlova
pip install --user parlova

# no Python packaging tools? (macOS / Linux)
curl -fsSL https://parlova.co.za/cli/install.sh | sh
# Windows PowerShell
irm https://parlova.co.za/cli/install.ps1 | iex

2. サインインします。 ブラウザーが開きます。コードを確認して「Approve」をクリックしてください。

parlova login

3. AI アプリに接続します

parlova mcp-config                    # Claude Desktop → paste into claude_desktop_config.json
parlova mcp-config --app cursor       # Cursor → ~/.cursor/mcp.json
parlova mcp-config --app vscode       # VS Code → .vscode/mcp.json
parlova mcp-config --app claude-code  # Claude Code → prints a `claude mcp add …` command to run

mcp-config は、お使いのマシンのフルパスを含む設定を出力します。デスクトップアプリからはシェルの PATH が見えないため、通常は "command": "parlova" だけでは動作しません。設定を編集した後、アプリを再起動してください。

uv をお使いの場合は、先にインストールしなくてもどこでも使える次の設定を利用できます。

{
  "mcpServers": {
    "parlova": { "command": "uvx", "args": ["parlova", "mcp"] }
  }
}

（先に uvx parlova login を一度実行するか、Settings → Developers から取得したトークンを使って "env": {"PARLOVA_TOKEN": "…"} を追加してください。）

ツール

ツール	機能	引数
transcribe_file	コンピューター上の音声または動画ファイルを文字起こしし、テキストを返します。結果を待機し、時間がかかる場合はジョブ ID を返します。	path（絶対パス）、language（デフォルトは auto、または af、en など）、speakers（bool）、max_wait_seconds（デフォルトは 240）
transcribe_youtube	YouTube のリンクを文字起こしします	url、language、speakers、max_wait_seconds
get_transcript	ジョブ ID で完了した文字起こしを取得します	job_id、format：text（読みやすい形式、タイムスタンプ＋話者）、txt、srt、vtt、csv、md、json
list_transcripts	ID、ステータス、日付、タイトル付きの最近の文字起こしを表示します	limit（デフォルトは 20）
get_usage	今月の使用分数、プランの上限、過去数か月分を表示します	—

話者ラベルには Plus または Pro が必要です。md と json 形式でのダウンロードは Pro のみです。プランの上限：Plus は月 10 時間、録音 1 時間まで、Pro は月 30 時間、録音 3 時間までです。

プロンプトの例

1. 「~/Downloads/team-meeting.m4a を話者付きで文字起こしして、担当者が分かるようにアクション項目を列挙してください。」
2. 「この YouTube 講演を文字起こしし、タイムスタンプ付きで重要なアイデアを 5 つ教えてください：https://www.youtube.com/watch?v=…」
3. 「~/Desktop/interview.mp3 を文字起こししてください。主にアフリカーンス語で、一部英語です。その後、話者ラベルを残したまま英語に翻訳してください。」
4. 「最後の文字起こしの SRT 字幕を取得し、動画と同じ場所に talk.srt として保存してください。」
5. 「今月、文字起こしに何分使いましたか？また、直近 5 件の文字起こしはどのような内容でしたか？」

コマンドライン

parlova transcribe meeting.m4a --speakers
parlova transcribe "https://youtu.be/…" --format srt -o talk.srt
parlova list
parlova get <job-id> --format vtt
parlova usage

サーバーや CI の場合：parlova login --token を実行するか、PARLOVA_TOKEN を設定してください。

プライバシー

音声は文字起こしの作成にのみ使用されます。アップロードされた音声は文字起こしが完了すると削除され、音声処理プロバイダーが音声を保存したり、学習に使用したりすることはありません。文字起こしはいつでも削除できます。プライバシーポリシー

ライセンス

MIT