assemblyai-mcp

MCP-сервер для API AssemblyAI. Транскрипция, субтитры, реплики говорящих, поиск по словам и LeMUR — всё это доступно как инструменты, которые может вызывать агент.

Написан, потому что мне нужен был такой сервер, а готового не было.

Установка

npm install -g assemblyai-mcp

Claude Code:

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

Всё остальное, что говорит по MCP через stdio:

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

Ключи берутся из панели управления.

Инструменты

Три решения, о которых стоит знать

transcribe ожидает. Если агенту выдать идентификатор задания и статус queued, он вынужден изобретать цикл опроса, и обычно изобретает плохой: фиксированный интервал, без верхнего предела, без сообщения, когда сдаётся. Ожидание — это то, что имел в виду вызывающий. Передайте wait: false, если вам действительно нужен идентификатор. При тайм-ауте в сообщении об ошибке говорится, что транскрипт не потерян, и называется инструмент, который его получит.

Длинный вывод ограничен, и об этом сообщается. Транскрипты достигают сотен килобайт. Инструмент, который возвращает всё, тратит контекстное окно на текст, который агент всё равно собирается резюмировать. Всё, что может быть длинным, принимает лимит и сообщает, сколько было обрезано, а не молча усекает.

Миллисекунды становятся секундами. API говорит в миллисекундах, что правильно для API и неправильно для модели, пишущей ответ, который прочитает человек. Временные метки выводятся в секундах с одним десятичным знаком.

Разработка

npm install
npm run build
npm test

API-клиент (src/api.ts) ничего не знает о MCP и принимает внедряемый fetch, поэтому тесты работают со скриптовым транспортом без сети и без ключа. Тесты покрывают то, что обычно ломается в тонкой обёртке над API: ключ не попадает в URL, идентификаторы экранируются, чтобы враждебный идентификатор не мог изменить путь, не-JSON ответы (субтитры приходят как текст), тела ошибок, показывающие предложение, написанное API, а не голый статус, и остановка цикла опроса как на completed, так и на error.

Примечание для AssemblyAI

Если что-то из этого вам пригодится — берите. Это MIT, и это ваш форк, переименование, поглощение или отказ. Если вы предпочитаете иметь это как сервер первой стороны, я готов помочь довести его до этого состояния.

MIT.