MarkItDown MCP: primero convierte una página https pública a Markdown

Para quién

Para convertir en esta máquina un documento o una página web a Markdown y entregárselo a un agente de confianza. La evidencia indica: markitdown-mcp ofrece servidores ligeros STDIO, Streamable HTTP y SSE, y expone una sola herramienta, convert_to_markdown(uri); la uri puede ser http:, https:, file: o data:.

Está pensado para agentes locales de confianza. No hay autenticación; los permisos del proceso igualan al usuario que lo arrancó. convert_to_markdown puede leer cualquier archivo que ese usuario pueda leer, y obtener datos de red. No lo abras a clientes no confiables en una máquina compartida.

La evidencia no lista clientes. No enlaces HTTP/SSE a algo que no sea localhost salvo que conozcas el riesgo.

Primera prueba en 3 minutos

Sigue la ruta principal pip; no tomes Docker como instalación principal:

pip install markitdown-mcp
markitdown-mcp

STDIO es el valor por defecto. Cuando necesites HTTP/SSE, la evidencia da:

markitdown-mcp --http --host 127.0.0.1 --port 3001

La primera vez usa STDIO y deja el enlace en esta máquina.

Requisitos: Python/pip locales funcionan; la primera conversión es una página https: a la que tienes acceso público — no alimentes primero un archivo de claves ni un file: interno. Esto leerá la URI que indiques y puede salir a la red.

Dónde configurar: en el MCP del cliente, command = markitdown-mcp (stdio). Abre HTTP solo cuando entiendas que cualquier proceso de esta máquina puede acceder.

Primera llamada de bajo riesgo: convert_to_markdown(uri) con una uri https: pública. No uses file: hacia el directorio personal o secretos, y no cambies --host.

Señal de éxito: la herramienta devuelve el Markdown convertido de esa URI. Si el proceso no arranca, comprueba primero el nombre del paquete pip; no pases a Docker.

Casos de uso

Caso 1: convertir una página pública a Markdown. Llama convert_to_markdown con uri https:. La evidencia solo garantiza que acepta este tipo de URI; no documenta estilo de salida, tope de tamaño ni muros de inicio de sesión. Lo confirmable: ves el texto convertido.

Caso 2: convertir un archivo local a Markdown. uri file:. Lee el disco con los permisos del usuario del servidor; en modo HTTP/SSE, otros procesos de esta máquina pueden disparar la misma lectura. Confirma primero que la ruta no tiene secretos. Una URI data: también entra en la conversión; la evidencia no documenta límite de longitud. El build Docker es docker build -t markitdown-mcp:latest . y luego docker run -it --rm markitdown-mcp:latest, que no es la misma ruta principal que pip.

Límites de uso

Sin autenticación; los permisos igualan al usuario que arranca. HTTP/SSE se enlaza por defecto a localhost y aun así lo pueden alcanzar otros procesos o usuarios de esta máquina. No lo enlaces a otra NIC. La única herramienta es convert_to_markdown. Puede leer archivos y datos de red que el usuario pueda leer: no es riesgo cero ni una escritura reversible — la evidencia no tiene undo. No trates Docker y pip como instalaciones principales en paralelo.