CrispASR Agent Transcriber MCP server

crispasr-agent-transcriber

<!-- mcp-name: io.github.EmiyaKatuz/crispasr-agent-transcriber -->

Local-only transcription for Codex and MCP-based AI agents, powered by CrispASR. No cloud uploads, no API keys required for transcription.

GitHub Release

What it does

Give it a local audio or video file. It:

for English, Qwen3-ASR for Chinese.

1. Probes the spoken language (English or Chinese) using CrispASR's FireRed LID.
2. Starts a local CrispASR server with the right backend -- Cohere Transcribe

agent-readable manifest.

1. Extracts audio from video with ffmpeg when needed.
2. Calls CrispASR's /v1/audio/transcriptions endpoint.
3. Writes the transcript and metadata to disk.
4. For video understanding, captures synchronized keyframes and writes an

Everything runs on your machine. Media never leaves it.

Quick install for Codex

The plugin includes the Codex Skill, command-line tool, and MCP server. Media stays on your computer. Model files are never downloaded during install/update; use the explicit models command when you want the installer to fetch them.

1. Install prerequisites

Install Node.js 20 or newer, uv, and ffmpeg. The installer uses uv to provide Python.

node --version
uv --version
ffmpeg -version

2. Run the installer

npx @emiyakatuz/crispasr-agent-transcriber@latest install

The installer:

• downloads the matching GitHub Release and verifies its SHA-256 checksum;
• installs the plugin under ~/plugins/crispasr-agent-transcriber;
• installs the Python and MCP dependencies;
• detects CUDA, Vulkan, or CPU and installs the best CrispASR build;
• registers the plugin in the Codex Personal marketplace;
• preserves existing models, binaries, and outputs during updates.

3. Add the local models

Download the recommended local English, Chinese, and language-detection bundle:

npx @emiyakatuz/crispasr-agent-transcriber@latest models

The command downloads only approved GGUF files into:

~/plugins/crispasr-agent-transcriber/models/

Then verify the installation:

npx @emiyakatuz/crispasr-agent-transcriber@latest doctor

4. Enable the plugin

With a Codex build that supports plugin commands, run:

codex plugin add crispasr-agent-transcriber@personal

If the CLI has no codex plugin command, open the Codex desktop Plugins view and install CrispASR Transcriber from the Personal marketplace. Start a new conversation, then ask:

Transcribe C:\path\to\sample.mp4 with CrispASR using auto language detection.
Save a verbose JSON transcript and an SRT subtitle file.

Update or uninstall

npx @emiyakatuz/crispasr-agent-transcriber@latest update
npx @emiyakatuz/crispasr-agent-transcriber@latest uninstall

Uninstall preserves local models, CrispASR binaries, and outputs. Use uninstall --purge-data only when those files should also be deleted. See Plugin installation for manual installation and troubleshooting.

Direct command-line use

After installation, you can run the transcription script without Codex:

Set-Location (Join-Path $HOME "plugins\crispasr-agent-transcriber")
uv run python scripts/transcribe.py sample.mp4 --profile auto `
  --manage-server `
  --models-dir models `
  --format verbose_json

Use with other AI agents

Shortened. The full README is on GitHub.