Skip to main content
Glama

tool-transcribai-mcp

Servidor MCP (Model Context Protocol) para transcribir texto de imágenes con OCR local (tesseract.js, WASM, sin internet y sin gastar tokens) y generar descripciones breves con bajo consumo de tokens.

Compatible con ChatGPT, Claude, opencode, Cursor y cualquier cliente MCP.

Herramientas

Herramienta

Descripción

transcribir_imagen

OCR local de una imagen → texto plano + bloques con su confianza

listar_imagenes

Lista las imágenes soportadas de un directorio (ruta y tamaño)

analizar_imagen

OCR + descripción breve opcional → Markdown, texto plano o JSON (puede guardar archivo)

procesar_carpeta

Procesa todas las imágenes de una carpeta en lote, un archivo de salida por imagen

Related MCP server: Mistral OCR MCP Server

Cómo funciona

  • OCR 100% local: tesseract.js corre dentro del servidor (WASM). La imagen nunca sale de tu máquina y no se consumen tokens.

  • Descripción IA opcional: si configuras una API key (OPENAI_API_KEY o TOOL_TRANSCRIBAI_API_KEY), describe envía solo el texto OCR (no la imagen) al modelo con un prompt corto (máx. 3 frases), minimizando tokens.

  • Seguridad por defecto: toda ruta se resuelve contra allowedRoot (path traversal bloqueado), con límites de tamaño (20 MB) y de lote (100 imágenes).

Uso con un cliente MCP

Configúralo con uvx, npx o la ruta directa al binario. Ejemplo con npx:

{
  "mcpServers": {
    "transcribai": {
      "command": "npx",
      "args": ["tool-transcribai-mcp"]
    }
  }
}

O en modo local (tras npm install && npm run build):

{
  "mcpServers": {
    "transcribai": {
      "command": "node",
      "args": ["<ruta>/tool-transcribai-mcp/dist/index.js"]
    }
  }
}

Modo Streamable HTTP (opcional)

TOOL_TRANSCRIBAI_HTTP=1 TOOL_TRANSCRIBAI_HTTP_PORT=3397 npm run start

Instalación / desarrollo

npm install
npm run dev        # servidor stdio con tsx
npm run build      # compila a dist/
npm test           # tests (Vitest)
npm run typecheck

Requisitos: Node.js 18+.

Configuración

Variable

Defecto

Descripción

TOOL_TRANSCRIBAI_ROOT

cwd

Directorio raíz permitido

TOOL_TRANSCRIBAI_MAX_IMAGE_BYTES

20 MB

Tamaño máximo por imagen

TOOL_TRANSCRIBAI_MAX_BATCH

100

Máx. imágenes por carpeta

TOOL_TRANSCRIBAI_LANG_PATH

—

Datos de idioma Tesseract locales (offline)

TOOL_TRANSCRIBAI_HTTP

—

1 para activar modo HTTP

TOOL_TRANSCRIBAI_HTTP_PORT

3397

Puerto del modo HTTP

TOOL_TRANSCRIBAI_API_KEY / OPENAI_API_KEY

—

API key para la descripción IA

TOOL_TRANSCRIBAI_DESCRIBE_MODEL

gpt-4o-mini

Modelo de descripción

Idiomas OCR

eng (defecto), spa, fra, deu, ita, por, nld, cat, eus, glg, ron, ces, pol, rus, ukr, tur, ara, hin, jpn, kor, chi_sim, chi_tra.

Licencia

MIT. Ver LICENSE.

Available Tools

4 tools
analizar_imagenAnalizar imagenB

Transcribe el texto de una imagen, genera una descripción breve (opcional) y devuelve el contenido en Markdown, texto plano o JSON. Puede guardar el resultado como archivo.

Inputs: ruta (required), idioma, formato, guardar, +3 more.

listar_imagenesListar imágenesA

Lista las imágenes soportadas dentro de un directorio (dentro de la raíz permitida), con su ruta y tamaño.

Inputs: carpeta (required).

procesar_carpetaProcesar carpeta de imágenesA

Procesa TODAS las imágenes de un directorio: transcribe cada una con OCR local y genera un archivo de salida por imagen, sin gastar tokens. Ideal para lotes grandes.

Inputs: carpeta (required), idioma, formato, carpetaSalida, +2 more.

transcribir_imagenTranscribir imagenA

Extrae el texto de una imagen usando OCR local (tesseract.js). No sube la imagen a internet y no gasta tokens. Devuelve el texto plano.

Inputs: ruta (required), idioma, bloques.

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 4 tools

    Disambiguation2/5

    transcribir_imagen and analizar_imagen both extract text from a single image and heavily overlap in purpose, with the latter only adding optional description/output options. procesar_carpeta also performs transcription, creating further ambiguity between batch and single-image workflows.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in Spanish using snake_case: transcribir_imagen, listar_imagenes, analizar_imagen, procesar_carpeta. Minor pluralization differences do not undermine the clear pattern.

    Tool Count4/5

    Four tools is a reasonable number for an OCR-focused server. However, the overlap between transcribir_imagen and analizar_imagen makes the set feel slightly less tight than it could be.

    Completeness4/5

    The server covers listing supported images, single-image OCR, richer analysis with configurable output, and batch folder processing. There are no major dead ends for the stated OCR purpose, though a tool to configure OCR language or supported extensions would round it out.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers