whipscribe-mcp

whipscribe-mcp

mcp-name: io.github.neugence/whipscribe-mcp

Whipscribe 用 MCP サーバーです。Claude Desktop、Claude Code、Cursor、Windsurf、または MCP 対応クライアントから、URL やローカルファイルの音声・動画を文字起こしできます。

⚠️ ベータサービス

• whipscribe-mcp と Whipscribe API はベータ版です。エンドポイント、レスポンスの形式、利用枠は予告なく変更される場合があります。
• ジョブが失敗したり、停止したり、部分的な出力を返したりすることがあります。再試行の処理はご自身で行ってください。
• ベータクレジットは予告なく無効になる場合があります（インフラ移行、キーの漏えい、料金体系のリセットなど）。ベータクレジットは現金には交換できません。
• 有効なキーに影響する料金変更を行う場合は、7 日前までに書面でお知らせします。また、未使用のクレジットは、お知らせから 7 日間、旧料金でご利用いただけます。
• 文字起こしの失敗が法的、安全上、または金銭的な結果につながる本番環境での利用には適していません。
• このパッケージをインストールして使用することで、whipscribe.com/terms に記載されたすべての規約に同意したものとみなされます。

インストール

uvx whipscribe-mcp

別の方法：

pipx install whipscribe-mcp
pip install whipscribe-mcp

Python 3.10 以降が必要です。

Claude Desktop

claude_desktop_config.json に追加します。

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

任意：env に WHIPSCRIBE_API_KEY を設定すると、有料利用枠を利用できます。

{
  "mcpServers": {
    "whipscribe": {
      "command": "uvx",
      "args": ["whipscribe-mcp"],
      "env": {
        "WHIPSCRIBE_API_KEY": "your-key"
      }
    }
  }
}

Claude Desktop を再起動します。「このポッドキャストの URL を文字起こしして……」と入力すると、Claude がツールを呼び出します。

ツール

ツール	説明
transcribe_url(url, language?, diarize?, word_timestamps?)	任意の URL（YouTube、ポッドキャストのフィード、ファイルへの直接リンク）の音声・動画を文字起こしします。
transcribe_file(path, language?, diarize?, word_timestamps?)	ローカルの音声・動画ファイルを文字起こしします。
get_job_status(job_id)	実行中のジョブの進行状況を確認します。
get_transcript(job_id, format)	txt、json、srt、vtt、docx 形式で文字起こし結果を取得します。
list_recent_jobs(limit?)	最近のジョブを表示します（ローカルキャッシュ）。

すべてのツールは、次の形式の JSON オブジェクトを返します。

{
  "ok": true,
  "job_id": "...",
  "status": "done",
  "transcript_preview": "first 300 chars...",
  "url_to_full": "https://whipscribe.com/view?id=...",
  "duration_sec": 967.3,
  "beta_notice": "..."
}

失敗時：

{
  "ok": false,
  "error": {
    "code": "upload_failed",
    "message": "human-readable explanation",
    "retryable": true
  }
}

環境変数

変数	必須	デフォルト	用途
WHIPSCRIBE_API_KEY	いいえ	—	API キー（ジョブをアカウントとそのクレジットに紐付けます。設定しなくても、すべての録音で無料プレビューを利用できます）
WHIPSCRIBE_API_BASE	いいえ	https://whipscribe.com/api/v1	API のベース URL を上書きします（例：ステージング環境用）
WHIPSCRIBE_MCP_TELEMETRY	いいえ	1	0 に設定すると、匿名の利用状況テレメトリーを無効にします
WHIPSCRIBE_MCP_POLL_TIMEOUT_SECONDS	いいえ	600	transcribe_url / transcribe_file が、終端状態でない job_id を返すまで待機する最大秒数
WHIPSCRIBE_MCP_POLL_INTERVAL_SECONDS	いいえ	3	文字起こし中にジョブの状態を確認する間隔（秒）

プライバシー

匿名テレメトリーはオプトイン方式です（デフォルトで有効。WHIPSCRIBE_MCP_TELEMETRY=0 で無効にできます）。

収集するデータ（メタデータのみ）：

• 匿名のインストールハッシュ：sha256(machine_id + salt)[:16]
• パッケージのバージョン、OS、Python のバージョン
• ツール名、所要時間（ミリ秒）、エラーコード

収集しないデータ：

• 文字起こしする URL
• ローカルファイルのパス
• API キー
• 文字起こしのテキスト
• メールアドレスや、個人を特定できる情報

匿名化アルゴリズムはこのリポジトリ（src/whipscribe_mcp/telemetry.py）にあります。内容を確認してください。許容できない場合は無効にしてください。

料金

現在の料金については、whipscribe.com/pricing をご覧ください。API キーの有無にかかわらず、すべての録音で無料プレビューを利用できます。クレジットパックは 6 ドルからで、有効期限はありません。Workspace プランは月額 19 ドルです（月 300 時間までの公正利用）。

ライセンス

Apache License 2.0。Copyright 2026 Neugence Technology Pvt. Ltd.

お問い合わせ

• ウェブサイト：whipscribe.com
• メール：[email protected]
• 課題：github.com/neugence/whipscribe-mcp/issues