assemblyai-mcp

Ein MCP-Server für die AssemblyAI API. Transkription, Untertitel, Sprecherbeiträge, Wortsuche und LeMUR, bereitgestellt als Werkzeuge, die ein Agent aufrufen kann.

Geschrieben, weil ich einen brauchte und es keinen gab.

Installation

npm install -g assemblyai-mcp

Claude Code:

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

Alles andere, das MCP über stdio spricht:

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

Schlüssel gibt es im Dashboard.

Tools

Drei Entscheidungen, die Sie kennen sollten

transcribe wartet. Ein Agent, der eine Job-ID und einen Status queued erhält, muss sich eine Polling-Schleife ausdenken, und meist erfindet er eine schlechte: festes Intervall, keine Obergrenze, keine Meldung, wenn er aufgibt. Warten ist das, was der Aufrufer gemeint hat. Übergeben Sie wait: false, wenn Sie tatsächlich die ID möchten. Bei Zeitüberschreitung sagt der Fehler, dass das Transkript nicht verloren ist, und nennt das Werkzeug, das es abrufen wird.

Lange Ausgaben sind begrenzt und weisen darauf hin. Transkripte können Hunderte Kilobyte umfassen. Ein Werkzeug, das alles zurückgibt, verbraucht das Kontextfenster für Text, den der Agent ohnehin zusammenfassen wird. Alles, was lange laufen kann, akzeptiert ein Limit und berichtet, wie viel es gekürzt hat, anstatt stillschweigend abzuschneiden.

Millisekunden werden zu Sekunden. Die API spricht in Millisekunden, was für eine API richtig und für ein Modell falsch ist, das eine Antwort schreibt, die ein Mensch lesen wird. Zeitstempel werden als Sekunden mit einer Dezimalstelle ausgegeben.

Entwicklung

npm install
npm run build
npm test

Der API-Client (src/api.ts) weiß nichts über MCP und nimmt ein injiziertes fetch entgegen, sodass die Tests gegen einen skriptbasierten Transport ohne Netzwerk und ohne Schlüssel laufen. Die Tests decken ab, was in einem schlanken API-Wrapper gerne bricht: der Schlüssel, der nie eine URL erreicht, IDs, die escaped werden, sodass eine böswillige ID den Pfad nicht verändern kann, Nicht-JSON-Antworten (Untertitel kommen als Text an), Fehlerantworten, die den Satz der API anzeigen statt eines bloßen Status, und die Polling-Schleife, die sowohl bei completed als auch bei error stoppt.

Hinweis für AssemblyAI

Wenn Ihnen davon etwas nützt, nehmen Sie es. Es ist MIT-lizenziert und gehört Ihnen: Sie können es forken, umbenennen, übernehmen oder verwerfen. Wenn Sie es lieber als First-Party-Server hätten, helfe ich gerne dabei, es dorthin zu bringen.

MIT.