MistralDocAI MCP Server

Un servidor MCP que convierte documentos e imágenes a Markdown usando los modelos OCR y de visión de Mistral AI. Dirígelo a un PDF, una presentación, un documento de Word o una imagen escaneada, y tu cliente MCP recibirá Markdown.

Está pensado para personas que ya usan un cliente MCP como Claude Desktop y quieren la conversión de documentos dentro de él, en lugar de como una herramienta separada.

Estado: mantenido activamente, con el mejor esfuerzo, como proyecto personal. La versión 2.0 es la actual. Consulta Versionado y compatibilidad antes de actualizar desde 1.x.

Idioma: este proyecto es solo en inglés. El texto de la interfaz, la documentación y los mensajes de error están en inglés, y no se publican compilaciones localizadas. Los documentos que proceses pueden estar en cualquier idioma que admitan los modelos de Mistral.

Requisitos

No instalas las dependencias de Python tú mismo. El servidor crea un entorno virtual en ~/.mistraldocai-mcp/ en la primera ejecución.

Related MCP server: Mistral OCR MCP Server

Instalación

Verifica que tu máquina puede ejecutarlo:

npx @trsdn/mistraldocai-mcp-server --test

Eso crea el entorno de Python, instala las dependencias, importa el servidor e informa de lo que encontró. Ejecútalo antes de configurar un cliente, porque convierte un fallo silencioso del lado del cliente en un error legible.

Configuración

Tu clave API

O expórtala en el entorno desde el que tu cliente lanza el servidor:

export MISTRAL_API_KEY=your_key_here

O ponla en ~/.mistraldocai-mcp/.env, que el servidor crea en la primera ejecución:

MISTRAL_API_KEY=your_key_here

El archivo suele ser la opción más fiable, porque los clientes MCP de escritorio a menudo no heredan el entorno de tu shell.

Claude Desktop

Añade esto a claude_desktop_config.json:

{
  "mcpServers": {
    "mistraldocai": {
      "command": "npx",
      "args": ["@trsdn/mistraldocai-mcp-server"],
      "env": {
        "MISTRAL_API_KEY": "your_key_here"
      }
    }
  }
}

Otros clientes

Cualquier cliente que lance un servidor MCP sobre stdio funciona. Usa npx @trsdn/mistraldocai-mcp-server como comando y proporciona MISTRAL_API_KEY en el entorno.

Herramientas

process_document

Convierte un documento o imagen a Markdown. Dale una ruta o contenido base64.

{ "name": "process_document", "arguments": { "file_path": "/path/to/report.pdf" } }

process_directory

Convierte todos los archivos compatibles en un directorio, escribiendo un archivo .md por entrada y preservando la estructura de directorios.

get_supported_formats

Devuelve los formatos compatibles y sus límites. No toma parámetros.

Formatos compatibles

Los límites los establece la API OCR de Mistral: 50 MB por archivo y 1.000 páginas por documento. Los precios y el rendimiento son de Mistral, no de este proyecto; consulta su página de precios para cifras actuales en lugar de confiar en un número copiado en un README.

Datos y privacidad

Los documentos que procesas se envían a Mistral AI. Este es el propósito principal del servidor, pero significa que el contenido sale de tu máquina. No proceses material que no tengas permitido compartir con un proveedor de IA de terceros.

Accesibilidad

La salida de consola es ASCII simple, sin color ni símbolos decorativos, por lo que sigue siendo legible en un lector de pantalla, en un terminal de Windows y en un registro de cliente que elimina el formato.

Limitación conocida: el servidor no tiene interfaz propia. Todo lo que ves proviene de tu cliente MCP, por lo que el acceso por teclado, el manejo del foco y el contraste son comportamiento de tu cliente, no de este proyecto. Los problemas de accesibilidad en la vista de conversación pertenecen al rastreador de incidencias de tu cliente.

Versionado y compatibilidad

Este proyecto sigue Versionado Semántico. Una versión principal es donde sube el mínimo de Node, la dependencia mcp de Python cruza una versión principal, o cambia el contrato de una herramienta.

Actualizar desde 1.x requiere Node.js 22 o posterior. Las versiones 1.0.4 y anteriores no se pueden instalar desde un entorno limpio en absoluto: sus requisitos de Python no estaban acotados y ahora se resuelven a versiones incompatibles. No hay un respaldo 1.x compatible. El relato completo está en CHANGELOG.md.

Cómo funciona

MCP client  --stdio-->  dist/index.js  --spawn-->  python/mcp_server.py  --HTTPS-->  api.mistral.ai
                             |                            |
                    manages ~/.mistraldocai-mcp/    docmistral.py does the
                    venv, deps, and .env            conversion

Dos restricciones explican la mayor parte del diseño:

• stdout es el protocolo. El cliente MCP analiza stdout como JSON-RPC, por lo que cada diagnóstico en ambos idiomas va a stderr. Un print suelto corrompe la sesión.

• El directorio del paquete es de solo lectura. Una instalación global de npm no se puede escribir, por lo que el entorno virtual, el .env y todo el resto del estado viven bajo ~/.mistraldocai-mcp/.

Desarrollo

git clone https://github.com/trsdn/MistralDocAI-mcp.git
cd MistralDocAI-mcp
npm ci
npm run build

Valida un cambio con el único comando que también ejecuta CI:

npm run verify

Si cambiaste algo bajo python/, ejecuta también ruff check . y python3 scripts/verify_python_server.py contra un intérprete que tenga instalado python/mcp_requirements.txt.

AGENTS.md contiene el diseño completo, las convenciones y la lista de operaciones prohibidas. Está escrito para agentes de IA, y también es la orientación más rápida para un humano.

Documentos del proyecto

Licencia

MIT.

Este repositorio se evalúa contra el Estándar de Calidad de Repositorios de trsdn. El resultado se registra en .github/conformance.yml, con evidencia por criterio en docs/self-assessment.md.