Skip to main content
Glama

assemblyai-mcp

AssemblyAI API 用のMCPサーバー。文字起こし、字幕、話者ターン、単語検索、LeMURを、エージェントが呼び出せるツールとして公開します。

必要だったが、既存のものがなかったため書きました。

インストール

npm install -g assemblyai-mcp

Claude Code:

claude mcp add assemblyai -e ASSEMBLYAI_API_KEY=your-key -- npx -y assemblyai-mcp

stdio で MCP を話すその他のツール:

{
  "mcpServers": {
    "assemblyai": {
      "command": "npx",
      "args": ["-y", "assemblyai-mcp"],
      "env": { "ASSEMBLYAI_API_KEY": "your-key" }
    }
  }
}

キーはダッシュボードから取得します。

Related MCP server: audio-transcription-mcp

ツール

ツール

説明

upload_file

ローカルの音声または動画ファイルをアップロードし、transcribe が受け付けるURLを取得する

transcribe

URLから音声または動画を文字起こしする。デフォルトでは結果を待つ

get_transcript

IDで文字起こし結果を取得する。実行中ならステータスも返す

list_transcripts

アカウント上の最近の文字起こし結果一覧

get_subtitles

完了した文字起こしのSRTまたはVTT

search_transcript

単語が発話された位置を、回数とタイムスタンプ付きで検索する

get_speaker_turns

speaker_labels 付きで文字起こしされた場合に、誰が何を言ったかを取得する

ask_transcript

1つ以上の文字起こしから、LeMURを通じて質問に答える

summarize_transcript

LeMURを通じて文字起こしを要約する

知っておく価値のある3つの設計判断

transcribe は待つ。 ジョブIDと queued ステータスを渡されたエージェントは、ポーリングループを自作しなければならず、しかも大抵は悪いループを自作する。固定間隔で、上限がなく、諦めるときのメッセージもない。呼び出し元が意図していたのは待つことだ。実際にIDが欲しい場合は wait: false を渡す。タイムアウト時、エラーは文字起こしが失われていないことを伝え、それを取得するツールを指名する。

長い出力は上限が設けられ、その旨が明示される。 文字起こしは数百キロバイトに及ぶ。すべてを返すツールは、エージェントがどうせ要約するテキストにコンテキストウィンドウを費やしてしまう。長時間かかる可能性のあるものはすべて、上限を受け取り、黙って切り詰めるのではなく、どれだけ削ったかを報告する。

ミリ秒は秒になる。 APIはミリ秒で応答する。これはAPIとしては正しいが、人が読む回答を書くモデルにとっては正しくない。タイムスタンプは小数点以下1桁の秒で出力される。

開発

npm install
npm run build
npm test

APIクライアント(src/api.ts)はMCPについて何も知らず、注入された fetch を受け取る。そのためテストは、ネットワークもキーもないスクリプト化されたトランスポートに対して実行される。テストは、薄いAPIラッパーで壊れがちなものをカバーしている: キーがURLに届かないこと、IDがエスケープされ、悪意のあるIDがパスを変形できないこと、JSON以外の応答(字幕はテキストとして届く)、エラーボディがステータスコードだけではなくAPIが書いた文章を表面化すること、そしてポーリングループが completed と error の両方で停止すること。

AssemblyAI へのメモ

この中のどれかが役に立つなら、使ってください。MITライセンスです。フォークしても、リネームしても、取り込んでも、捨てても構いません。もしファーストパーティのサーバーとして提供したいのであれば、その実現をお手伝いします。

MIT.

Available Tools

9 tools
ask_transcriptC

Ask a question answered from one or more transcripts.

Inputs: question (required), transcript_ids (required), model.

get_speaker_turnsB

Get who said what, for a transcript made with speaker_labels.

Inputs: transcript_id (required), max_turns.

get_subtitlesA

Get SRT or VTT subtitles for a completed transcript.

Inputs: format (required), transcript_id (required), chars_per_caption.

get_transcriptA

Fetch a transcript by id, including its status if it is still running.

Inputs: transcript_id (required), max_characters.

list_transcriptsB

List recent transcripts on the account.

Inputs: limit, status.

search_transcriptA

Find where words are spoken in a transcript. Returns counts and timestamps.

Inputs: words (required), transcript_id (required).

summarize_transcriptC

Summarise one or more transcripts.

Inputs: transcript_ids (required), model, context, answer_format.

transcribeB

Transcribe an audio or video file from a URL. Waits for the result by default.

Inputs: audio_url (required), wait, auto_chapters, language_code, +2 more.

upload_fileA

Upload a local audio or video file and get a URL that transcribe accepts.

Inputs: file_path (required), max_size_mb.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool targets a distinct part of the transcription workflow: upload, transcribe, retrieve, list, subtitles, search, speaker turns, Q&A, and summarization. Even the two transcript-based text tools, ask_transcript and summarize_transcript, are clearly separated by their descriptions.

    Naming Consistency4/5

    Almost all tools follow a clear verb_noun pattern (upload_file, get_transcript, list_transcripts, ask_transcript). The only minor deviation is 'transcribe', which is a bare verb without an explicit object, but it remains predictable given the server's purpose.

    Tool Count5/5

    Nine tools is a well-scoped set for a transcription-focused MCP server. Each tool earns its place, covering the main AssemblyAI features without unnecessary duplication or bloat.

    Completeness4/5

    The set covers the core lifecycle well: upload, transcribe, retrieve, list, subtitles, and several post-processing features. The main gap is the absence of a delete_transcript tool, which prevents full CRUD coverage, but agents can still complete typical transcription workflows.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers