LaTeX PDF MCP Server

Converte código-fonte LaTeX em documentos PDF formatados profissionalmente.

GitHub
1

Documentação

LaTeX PDF MCP Server

Um servidor Model Context Protocol (MCP) que fornece ferramentas para converter código-fonte LaTeX em documentos PDF. Este servidor permite que assistentes de IA gerem documentos PDF de alta qualidade a partir de marcação LaTeX com capacidades de formatação profissional.

Recursos

  • Conversão de LaTeX para PDF: Converta código-fonte LaTeX diretamente para o formato PDF
  • Geração de Documentos Profissionais: Suporta todos os recursos padrão do LaTeX para documentos acadêmicos e profissionais
  • Geração de Arquivos Locais: Cria arquivos PDF em um diretório especificado para fácil acesso
  • Integração com Servidor HTTP: Gera links de download para os PDFs criados
  • Tratamento de Erros: Relatórios de erros abrangentes para problemas de compilação LaTeX

Pré-requisitos

Antes de usar este servidor MCP, certifique-se de ter:

  1. Node.js (versão 18 ou superior)
  2. Distribuição LaTeX: Uma instalação LaTeX completa, como:
  3. latexmk: Geralmente incluído nas distribuições LaTeX

Instalação

Via npm (Recomendado)

npm install -g latexpdf-mcp

A partir do código-fonte

  1. Clone o repositório:
git clone https://github.com/ihor-sokoliuk/latexpdf-mcp.git
cd latexpdf-mcp
  1. Instale as dependências:
pnpm install
  1. Compile o projeto:
pnpm run build

Configuração

Configuração do Claude Desktop

Adicione o servidor ao arquivo de configuração do 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"
      }
    }
  }
}

Diretório de Saída

Por padrão, os PDFs são gerados em: C:\Users\Admin\Documents\GeneratedPDF

Você pode personalizar o diretório de saída definindo a variável de ambiente LATEXPDF_OUTPUT_DIR na sua configuração MCP.

Exemplos de configuração:

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

Depois de configurado, você pode usar o servidor por meio do seu cliente compatível com MCP:

Ferramentas Disponíveis

create_pdf

Converte código-fonte LaTeX em um documento PDF.

Parâmetros:

  • file_name (string, obrigatório): Nome do arquivo PDF de saída (deve terminar com .pdf)
  • latex_source (string, obrigatório): Código-fonte LaTeX a ser convertido

Exemplo:

\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}

Acesso ao PDF

Após gerar um PDF, você pode acessá-lo via servidor HTTP:

  1. Navegue até o diretório de saída (padrão: C:\Users\Admin\Documents\GeneratedPDF, ou seu LATEXPDF_OUTPUT_DIR personalizado):
cd [YOUR_OUTPUT_DIRECTORY]
  1. Inicie um servidor HTTP local:
python -m http.server
  1. Acesse seus PDFs em http://localhost:8000/[filename].pdf

O servidor fornece automaticamente links de download neste formato quando os PDFs são gerados.

Desenvolvimento

Estrutura do Projeto

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

Compilação

pnpm run build

Modo de Desenvolvimento

pnpm run watch

Solução de Problemas

Problemas Comuns

  1. LaTeX não encontrado: Certifique-se de que o LaTeX esteja instalado corretamente e que latexmk esteja no seu PATH
  2. Erros de permissão: Verifique as permissões de escrita para o diretório de saída
  3. Erros de compilação: Revise a sintaxe do LaTeX e os pacotes necessários

Mensagens de Erro

O servidor fornece mensagens de erro detalhadas para:

  • Instalação LaTeX ausente
  • Falhas de compilação
  • Permissões do sistema de arquivos
  • Parâmetros de entrada inválidos

Contribuindo

  1. Faça um fork do repositório
  2. Crie um branch de recurso
  3. Faça suas alterações
  4. Adicione testes, se aplicável
  5. Envie um pull request

Licença

Este projeto está licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.

Links

Autor

Ihor Sokoliuk - Perfil do GitHub

Este servidor MCP permite uma conversão perfeita de LaTeX para PDF em fluxos de trabalho assistidos por IA, perfeito para gerar artigos acadêmicos, documentação técnica e relatórios profissionais.