mcp-markdown-tools

Un servidor MCP (Model Context Protocol) que proporciona herramientas para trabajar con contenido Markdown. Analiza, corrige, formatea y genera Markdown mediante programación a través de cualquier cliente compatible con MCP.

Herramientas

generate_toc

Genera una tabla de contenido a partir de los encabezados de Markdown. Configura la profundidad mínima/máxima de los encabezados y elige entre una salida de lista ordenada o desordenada.

lint_markdown

Comprueba el Markdown en busca de problemas comunes, incluyendo sintaxis de enlaces rota, violaciones de la jerarquía de encabezados, espacios en blanco al final de las líneas, falta de texto alternativo en imágenes, marcadores de lista inconsistentes y exceso de líneas en blanco.

format_markdown

Formatea y embellece el contenido Markdown. Normaliza los estilos de encabezado (convierte setext a ATX), corrige el espaciado alrededor de los encabezados y bloques, alinea las columnas de las tablas y ajusta las líneas largas a un ancho configurable.

markdown_stats

Calcula estadísticas detalladas a partir del contenido Markdown: recuento de palabras, recuento de caracteres, tiempo de lectura estimado, encabezados por nivel, recuento de enlaces, recuento de imágenes, recuento de bloques de código con distribución por lenguaje, elementos de lista, citas en bloque y recuento de párrafos.

generate_table

Genera tablas Markdown formateadas a partir de datos JSON. Admite selección de columnas, etiquetas de encabezado personalizadas y alineación por columna (izquierda, centro, derecha).

Instalación

npm install
npm run build

Uso con Claude Desktop

Añade lo siguiente a tu archivo de configuración de Claude Desktop:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "markdown-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-markdown-tools/dist/index.js"]
    }
  }
}

Uso con Claude Code

Añade el servidor usando la CLI de Claude Code:

claude mcp add markdown-tools node D:/products/mcp-servers/mcp-markdown-tools/dist/index.js

O añádelo a tu configuración .mcp.json:

{
  "mcpServers": {
    "markdown-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-markdown-tools/dist/index.js"]
    }
  }
}

Desarrollo

npm install
npm run build
npm start

Licencia

MIT