LaTeX PDF MCP Server

Convierte código fuente LaTeX en documentos PDF con formato profesional.

GitHub
1
Prueba este MCPPatrocinado

Documentación

LaTeX PDF MCP Server

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para convertir código fuente LaTeX en documentos PDF. Este servidor permite a los asistentes de IA generar documentos PDF de alta calidad a partir de marcado LaTeX con capacidades de formato profesional.

Características

  • Conversión de LaTeX a PDF: Convierte código fuente LaTeX directamente a formato PDF
  • Generación de documentos profesionales: Soporta todas las características estándar de LaTeX para documentos académicos y profesionales
  • Generación de archivos locales: Crea archivos PDF en un directorio especificado para fácil acceso
  • Integración con servidor HTTP: Genera enlaces de descarga para los PDF creados
  • Manejo de errores: Informe completo de errores para problemas de compilación de LaTeX

Requisitos previos

Antes de usar este servidor MCP, asegúrate de tener:

  1. Node.js (versión 18 o superior)
  2. Distribución de LaTeX: Una instalación completa de LaTeX como:
    • Windows: MiKTeX o TeX Live
    • macOS: MacTeX
    • Linux: TeX Live (instalar mediante el gestor de paquetes)
  3. latexmk: Generalmente incluido con las distribuciones de LaTeX

Instalación

Desde npm (Recomendado)

npm install -g latexpdf-mcp

Desde el código fuente

  1. Clona el repositorio:
git clone https://github.com/ihor-sokoliuk/latexpdf-mcp.git
cd latexpdf-mcp
  1. Instala las dependencias:
pnpm install
  1. Compila el proyecto:
pnpm run build

Configuración

Configuración de Claude Desktop

Añade el servidor 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 Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "latexpdf-mcp": {
      "command": "latexpdf-mcp",
      "env": {
        "LATEXPDF_OUTPUT_DIR": "/path/to/your/pdf/directory"
      }
    }
  }
}

Directorio de salida

Por defecto, los PDF se generan en: C:\Users\Admin\Documents\GeneratedPDF

Puedes personalizar el directorio de salida estableciendo la variable de entorno LATEXPDF_OUTPUT_DIR en tu configuración de MCP.

Ejemplos de configuración:

Windows:

{
  "mcpServers": {
    "latexpdf-mcp": {
      "command": "latexpdf-mcp",
      "env": {
        "LATEXPDF_OUTPUT_DIR": "C:\\Users\\YourName\\Documents\\MyPDFs"
      }
    }
  }
}

macOS/Linux:

{
  "mcpServers": {
    "latexpdf-mcp": {
      "command": "latexpdf-mcp",
      "env": {
        "LATEXPDF_OUTPUT_DIR": "/home/yourname/Documents/PDFs"
      }
    }
  }
}

Uso

Una vez configurado, puedes usar el servidor a través de tu cliente compatible con MCP:

Herramientas disponibles

create_pdf

Convierte código fuente LaTeX en un documento PDF.

Parámetros:

  • file_name (string, requerido): Nombre del archivo PDF de salida (debe terminar en .pdf)
  • latex_source (string, requerido): Código fuente LaTeX a convertir

Ejemplo:

\documentclass{article}
\usepackage[utf8]{inputenc}
\title{Sample Document}
\author{Your Name}
\date{\today}

\begin{document}
\maketitle

\section{Introduction}
This is a sample LaTeX document generated via MCP.

\subsection{Features}
\begin{itemize}
    \item Professional formatting
    \item Mathematical expressions: $E = mc^2$
    \item Cross-references and citations
\end{itemize}

\end{document}

Acceso a PDF

Después de generar un PDF, puedes acceder a él mediante el servidor HTTP:

  1. Navega al directorio de salida (por defecto: C:\Users\Admin\Documents\GeneratedPDF, o tu LATEXPDF_OUTPUT_DIR personalizado):
cd [YOUR_OUTPUT_DIRECTORY]
  1. Inicia un servidor HTTP local:
python -m http.server
  1. Accede a tus PDF en http://localhost:8000/[filename].pdf

El servidor proporciona automáticamente enlaces de descarga en este formato cuando se generan los PDF.

Desarrollo

Estructura del proyecto

latexpdf-mcp/
├── index.ts              # Main server implementation
├── package.json          # Package configuration
├── tsconfig.json         # TypeScript configuration
├── pnpm-lock.yaml        # Dependency lock file
└── dist/                 # Compiled JavaScript output

Compilación

pnpm run build

Modo de desarrollo

pnpm run watch

Solución de problemas

Problemas comunes

  1. LaTeX no encontrado: Asegúrate de que LaTeX esté correctamente instalado y que latexmk esté en tu PATH
  2. Errores de permisos: Verifica los permisos de escritura para el directorio de salida
  3. Errores de compilación: Revisa la sintaxis de LaTeX y los paquetes requeridos

Mensajes de error

El servidor proporciona mensajes de error detallados para:

  • Instalación de LaTeX faltante
  • Fallos de compilación
  • Permisos del sistema de archivos
  • Parámetros de entrada no válidos

Contribuciones

  1. Haz un fork del repositorio
  2. Crea una rama de características
  3. Realiza tus cambios
  4. Añade pruebas si corresponde
  5. Envía una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

Enlaces

Autor

Ihor Sokoliuk - Perfil de GitHub

Este servidor MCP permite una conversión fluida de LaTeX a PDF en flujos de trabajo asistidos por IA, perfecto para generar artículos académicos, documentación técnica e informes profesionales.