Skip to main content
Glama

Servidor MCP Markdownify

logotipo de markdownify mcp

Markdownify es un servidor del Protocolo de Contexto de Modelo (MCP) que convierte varios tipos de archivos y contenido web a formato Markdown. Proporciona un conjunto de herramientas para transformar archivos PDF, imágenes, archivos de audio, páginas web y más en texto Markdown fácil de leer y compartir.

Características

  • Convertir múltiples tipos de archivos a Markdown:

    • PDF

    • Imágenes

    • Audio (con transcripción)

    • DOCX

    • XLSX

    • PPTX

  • Convertir contenido web a Markdown:

    • Transcripciones de videos de YouTube

    • Resultados de búsqueda de Bing

    • Páginas web generales

  • Recuperar archivos Markdown existentes

Related MCP server: Markdownify MCP Server

Primeros pasos

  1. Clona este repositorio

  2. Instala las dependencias:

    bun install

    El paso preinstall crea un entorno virtual de Python en .venv e instala markitdown[all].

  3. Compila el proyecto:

    bun run build
  4. Inicia el servidor:

    bun start

Desarrollo

  • Usa bun run dev para iniciar el compilador de TypeScript en modo de vigilancia

  • Modifica src/server.ts para personalizar el comportamiento del servidor

  • Añade o modifica herramientas en src/tools.ts

Uso con la aplicación de escritorio

Para integrar este servidor con una aplicación de escritorio, añade lo siguiente a la configuración del servidor de tu aplicación:

{
  "mcpServers": {
    "markdownify": {
      "command": "node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

Variables de entorno

Todas las rutas tienen valores predeterminados razonables; sobrescríbelas solo cuando los valores predeterminados no se ajusten a tu diseño de instalación.

Variable

Predeterminado

Propósito

MARKITDOWN_PATH

<project>/.venv/bin/markitdown, luego markitdown en PATH

Ruta absoluta al ejecutable markitdown. Configúralo cuando hayas instalado markitdown en todo el sistema (p. ej., pipx install "markitdown[pdf]") en lugar de usar el venv incluido.

REPOMIX_PATH

<project>/node_modules/.bin/repomix, luego repomix en PATH

Ruta absoluta al ejecutable repomix utilizado por git-repo-to-markdown.

MD_ALLOWED_PATHS

sin establecer (sin restricciones)

Lista separada por delimitadores de ruta (: en POSIX, ; en Windows) de directorios que el servidor tiene permitido leer. Cuando se establece, todas las herramientas de entrada de archivos (pdf-to-markdown, get-markdown-file, etc.) rechazan rutas fuera de estos directorios.

MD_SHARE_DIR

sin establecer

Alias obsoleto para MD_ALLOWED_PATHS (directorio único). Todavía se respeta por compatibilidad con versiones anteriores.

Uso con Docker

Compila y ejecuta:

docker build -t markdownify-mcp .
docker run --rm -i \
  -v "$HOME/Documents:/data:ro" \
  -e MD_ALLOWED_PATHS=/data \
  markdownify-mcp

Notas para el catálogo de Docker MCP (mcp/markdownify):

  • Monta cualquier directorio del host que desees que el servidor lea dentro del contenedor, luego pasa las rutas del contenedor a las herramientas (p. ej., /data/foo.pdf, no /Users/you/Documents/foo.pdf).

  • Establece MD_ALLOWED_PATHS en la lista separada por dos puntos de los directorios montados para que el servidor aplique un límite de lectura que coincida con el montaje de enlace.

  • La imagen de Docker publicada instala solo markitdown[pdf]: la transcripción de audio y el OCR de imágenes (audio-to-markdown, image-to-markdown) requieren los extras [all] y fallarán en la imagen ligera. Usa la instalación local (bun install) para el conjunto completo de funciones.

Herramientas disponibles

  • youtube-to-markdown: Convierte videos de YouTube a Markdown

  • pdf-to-markdown: Convierte archivos PDF a Markdown

  • bing-search-to-markdown: Convierte resultados de búsqueda de Bing a Markdown

  • webpage-to-markdown: Convierte páginas web a Markdown

  • image-to-markdown: Convierte imágenes a Markdown con metadatos

  • audio-to-markdown: Convierte archivos de audio a Markdown con transcripción

  • docx-to-markdown: Convierte archivos DOCX a Markdown

  • xlsx-to-markdown: Convierte archivos XLSX a Markdown

  • pptx-to-markdown: Convierte archivos PPTX a Markdown

  • get-markdown-file: Recupera un archivo Markdown existente. La extensión del archivo debe terminar en: *.md, *.markdown.

    OPCIONAL: establece MD_ALLOWED_PATHS para restringir cada herramienta de entrada de archivos a una lista de directorios, p. ej., MD_ALLOWED_PATHS=/data/in:/data/out bun start.

Contribuciones

¡Las contribuciones son bienvenidas! Por favor, siéntete libre de enviar una solicitud de extracción (Pull Request).

Licencia

Este proyecto está bajo la Licencia MIT - consulta el archivo LICENSE para obtener más detalles.

Available Tools

10 tools
audio-to-markdownC

Convert an audio file to markdown, including transcription if possible

Inputs: filepath (required).

bing-search-to-markdownC

Convert a Bing search results page to markdown

Inputs: url (required).

docx-to-markdownC

Convert a DOCX file to markdown

Inputs: filepath (required).

get-markdown-fileC

Get a markdown file by absolute file path

Inputs: filepath (required).

image-to-markdownC

Convert an image to markdown, including metadata and description

Inputs: filepath (required).

pdf-to-markdownC

Convert a PDF file to markdown

Inputs: filepath (required).

pptx-to-markdownC

Convert a PPTX file to markdown

Inputs: filepath (required).

webpage-to-markdownC

Convert a webpage to markdown

Inputs: url (required).

xlsx-to-markdownC

Convert an XLSX file to markdown

Inputs: filepath (required).

youtube-to-markdownC

Convert a YouTube video to markdown, including transcript if available

Inputs: url (required).

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

    Disambiguation5/5

    Each tool has a clearly distinct purpose focused on converting a specific input format (audio, Bing search, DOCX, etc.) to markdown. The descriptions specify unique source types, making it impossible to confuse which tool to use for a given conversion task.

    Naming Consistency5/5

    All tools follow a consistent pattern of 'source-to-markdown' (e.g., audio-to-markdown, docx-to-markdown). This uniform naming convention makes it easy to predict tool names and understand their functions at a glance.

    Tool Count5/5

    With 10 tools, the server covers a comprehensive range of common input formats (audio, documents, web content, spreadsheets, presentations, etc.) for markdown conversion. This count is well-scoped for the domain, providing thorough coverage without being overwhelming.

    Completeness5/5

    The tool set offers complete coverage for converting various media and file types to markdown, including audio, images, documents, webpages, and videos. There are no obvious gaps; each tool handles a distinct input format, ensuring agents can convert any supported source without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Converts various file types (documents, images, audio, web content) to markdown format without requiring Docker, supporting PDF, Word, Excel, PowerPoint, images, audio files, web URLs, and more.
      397 npm
      14
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Converts documents, webpages, and media files into markdown for AI assistants using Microsoft's MarkItDown and Crawl4AI. It enables tools to read PDFs, Office files, and JavaScript-rendered websites with support for OCR and image extraction.
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Converts files (PDF, images, audio, DOCX, XLSX, PPTX) and web content (YouTube transcripts, Bing search, general pages) to Markdown via the Model Context Protocol.
      Apache 2.0