CLI de Markovo y servidor MCP

Markovo convierte archivos compatibles y páginas HTTPS públicas explícitamente autorizadas en Markdown limpio y estructurado. Para acceder a la experiencia web dedicada y conocer los detalles del producto, visita el PDF to Markdown Converter.

Este repositorio público es la fuente de distribución de la CLI markovo del lado del cliente y del servidor MCP stdio markovo-mcp. No contiene ningún motor de conversión local, servicio backend, configuración de despliegue, credenciales de producción ni implementación de facturación. La conversión se realiza a través del servicio con medición por cuenta en https://markovo.net.

Instalación

pip install markovo

O ejecútala sin una instalación permanente:

uvx markovo --help
uvx --from markovo markovo-mcp

Related MCP server: MarkItDown MCP Server

Clave de API y créditos

1. Crea una clave de API en el Portal para desarrolladores.

2. Guárdala en tu shell o en el almacén de secretos del host MCP; no la pegues en prompts ni la confirmes en el control de versiones.

3. Verifica la configuración:

export MARKOVO_API_KEY="your-key"
markovo doctor --json

Cada conversión requiere un límite explícito de créditos. Cuando falta una clave, el cliente apunta al Portal para desarrolladores. Cuando los créditos son insuficientes, la respuesta del servicio apunta a la página de facturación para que la cuenta pueda recargarse antes de reintentar.

Configuración de MCP

{
  "mcpServers": {
    "markovo": {
      "command": "uvx",
      "args": ["--from", "markovo", "markovo-mcp"],
      "env": {
        "MARKOVO_API_KEY": "${MARKOVO_API_KEY}",
        "MARKOVO_MCP_ROOT": "/path/to/safe/project"
      }
    }
  }
}

Los clientes MCP deben inyectar MARKOVO_API_KEY a través de su configuración de secretos o de variables de entorno. La clave y el origen del servicio nunca son argumentos de herramientas MCP, por lo que los prompts no pueden redirigir la credencial. El cliente público acepta únicamente https://markovo.net y no sigue redirecciones autenticadas.

El servidor MCP solo puede leer y escribir dentro del MARKOVO_MCP_ROOT requerido. Configúralo como el directorio de proyecto dedicado más pequeño que necesite tu host MCP. Si falta, el servidor rechaza todas las herramientas de archivos; se rechazan los intentos de salida por directorio superior y por enlaces simbólicos.

export MARKOVO_MCP_ROOT="/path/to/safe/project"

Los errores estructurados apuntan al Portal para desarrolladores cuando falta una clave y a Facturación cuando los créditos son insuficientes.

Enlaces

• Inicio de Markovo

• PDF to Markdown

• Documentación

• Precios y créditos

• Portal para desarrolladores y claves de API

• Facturación y recarga

Seguridad

Notifica los problemas de seguridad de forma privada siguiendo las instrucciones de SECURITY.md. No incluyas claves de API, documentos de clientes ni resultados de conversión privados en un issue público.