Markdownify MCP Server
Servidor MCP Markdownify

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
Clona este repositorio
Instala las dependencias:
bun installEl paso
preinstallcrea un entorno virtual de Python en.venve instalamarkitdown[all].Compila el proyecto:
bun run buildInicia el servidor:
bun start
Desarrollo
Usa
bun run devpara iniciar el compilador de TypeScript en modo de vigilanciaModifica
src/server.tspara personalizar el comportamiento del servidorAñ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 |
|
| Ruta absoluta al ejecutable |
|
| Ruta absoluta al ejecutable |
| sin establecer (sin restricciones) | Lista separada por delimitadores de ruta ( |
| sin establecer | Alias obsoleto para |
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-mcpNotas 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_PATHSen 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 Markdownpdf-to-markdown: Convierte archivos PDF a Markdownbing-search-to-markdown: Convierte resultados de búsqueda de Bing a Markdownwebpage-to-markdown: Convierte páginas web a Markdownimage-to-markdown: Convierte imágenes a Markdown con metadatosaudio-to-markdown: Convierte archivos de audio a Markdown con transcripcióndocx-to-markdown: Convierte archivos DOCX a Markdownxlsx-to-markdown: Convierte archivos XLSX a Markdownpptx-to-markdown: Convierte archivos PPTX a Markdownget-markdown-file: Recupera un archivo Markdown existente. La extensión del archivo debe terminar en: *.md, *.markdown.OPCIONAL: establece
MD_ALLOWED_PATHSpara 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 toolsaudio-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
Scored across 10 tools
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.
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.
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.
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
Related MCP Connectors
Convert PDF, Word, Excel, PowerPoint, e-mails and web pages to clean Markdown for LLMs.
Documents to Markdown: PDF, DOCX, PPTX, XLSX, HTML. Scanned PDF pages read by AI.
Convert PDFs, Office docs, websites and audio into AI-ready Markdown, then search and ask your docs.
Documents to Markdown/PDF, OCR, video and audio transcripts, TTS, screenshots, domains, frames.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConverts 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 npm14MIT
- AlicenseAqualityDmaintenanceConverts various file types (PDF, images, audio, DOCX, XLSX, PPTX) and web content (YouTube videos, web pages, Bing search results) into Markdown format for easy reading and sharing.10MIT
- AlicenseNot gradedqualityDmaintenanceConverts 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.3MIT
- AlicenseNot gradedqualityDmaintenanceConverts 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