assemblyai-mcp
assemblyai-mcp
AssemblyAI API 用のMCPサーバー。文字起こし、字幕、話者ターン、単語検索、LeMURを、エージェントが呼び出せるツールとして公開します。
必要だったが、既存のものがなかったため書きました。
インストール
npm install -g assemblyai-mcpClaude Code:
claude mcp add assemblyai -e ASSEMBLYAI_API_KEY=your-key -- npx -y assemblyai-mcpstdio で MCP を話すその他のツール:
{
"mcpServers": {
"assemblyai": {
"command": "npx",
"args": ["-y", "assemblyai-mcp"],
"env": { "ASSEMBLYAI_API_KEY": "your-key" }
}
}
}キーはダッシュボードから取得します。
Related MCP server: audio-transcription-mcp
ツール
ツール | 説明 |
| ローカルの音声または動画ファイルをアップロードし、 |
| URLから音声または動画を文字起こしする。デフォルトでは結果を待つ |
| IDで文字起こし結果を取得する。実行中ならステータスも返す |
| アカウント上の最近の文字起こし結果一覧 |
| 完了した文字起こしのSRTまたはVTT |
| 単語が発話された位置を、回数とタイムスタンプ付きで検索する |
|
|
| 1つ以上の文字起こしから、LeMURを通じて質問に答える |
| LeMURを通じて文字起こしを要約する |
知っておく価値のある3つの設計判断
transcribe は待つ。 ジョブIDと queued ステータスを渡されたエージェントは、ポーリングループを自作しなければならず、しかも大抵は悪いループを自作する。固定間隔で、上限がなく、諦めるときのメッセージもない。呼び出し元が意図していたのは待つことだ。実際にIDが欲しい場合は wait: false を渡す。タイムアウト時、エラーは文字起こしが失われていないことを伝え、それを取得するツールを指名する。
長い出力は上限が設けられ、その旨が明示される。 文字起こしは数百キロバイトに及ぶ。すべてを返すツールは、エージェントがどうせ要約するテキストにコンテキストウィンドウを費やしてしまう。長時間かかる可能性のあるものはすべて、上限を受け取り、黙って切り詰めるのではなく、どれだけ削ったかを報告する。
ミリ秒は秒になる。 APIはミリ秒で応答する。これはAPIとしては正しいが、人が読む回答を書くモデルにとっては正しくない。タイムスタンプは小数点以下1桁の秒で出力される。
開発
npm install
npm run build
npm testAPIクライアント(src/api.ts)はMCPについて何も知らず、注入された fetch を受け取る。そのためテストは、ネットワークもキーもないスクリプト化されたトランスポートに対して実行される。テストは、薄いAPIラッパーで壊れがちなものをカバーしている: キーがURLに届かないこと、IDがエスケープされ、悪意のあるIDがパスを変形できないこと、JSON以外の応答(字幕はテキストとして届く)、エラーボディがステータスコードだけではなくAPIが書いた文章を表面化すること、そしてポーリングループが completed と error の両方で停止すること。
AssemblyAI へのメモ
この中のどれかが役に立つなら、使ってください。MITライセンスです。フォークしても、リネームしても、取り込んでも、捨てても構いません。もしファーストパーティのサーバーとして提供したいのであれば、その実現をお手伝いします。
MIT.
Available Tools
9 toolsask_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
Scored across 9 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for RiverScript, an AI transcription platform - fetches transcripts shared via a link.
MCP server for Speech-to-Text
An MCP server that provides tools to discover and retrieve podcast episodes transcripts.
An MCP server that provides congressional transcripts
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for audio transcription using local faster-whisper or OpenAI Whisper API, enabling multilingual transcription with optional GPT post-processing.3160 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceMCP server for audio transcription with speaker diarization. Transcribes MP3/WAV files using Faster-Whisper and pyannote.audio, outputs markdown with speaker labels, timestamps, summaries, and action items.1MIT
- AlicenseAqualityFmaintenanceMCP server for audio transcription using OpenRouter models, supporting verbatim, cleaned, and custom transcription modes.235 npm1MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that provides speech-to-text transcription and speaker diarization using OpenAI Whisper and pyannote.audio.-