TeXFlow

TeXFlow MCP

Um compilador de documentos LaTeX com uma interface MCP. Agentes de IA operam em um modelo de documento estruturado — seções, parágrafos, figuras, tabelas — enquanto o TeXFlow lida com todos os mecanismos LaTeX: pacotes, preâmbulo, fontes e compilação.

Instalação

pip install texflow-mcp

Ou execute sem instalar:

uvx texflow-mcp

Dependências do sistema (opcional)

O TeXFlow compila documentos para PDF usando XeLaTeX. Sem ele, você ainda pode criar e exportar arquivos .tex.

# Arch
pacman -S texlive-xetex texlive-fontsrecommended texlive-fontsextra

# Debian/Ubuntu
apt install texlive-xetex texlive-fonts-recommended texlive-fonts-extra

# Fedora
dnf install texlive-xetex texlive-collection-fontsrecommended texlive-collection-fontsextra

Para pré-visualização de página (PNG), instale poppler-utils (fornece pdftoppm).

Configure com o Claude Code

claude mcp add texflow -- uvx texflow-mcp

É isso. Reinicie o Claude Code e as ferramentas estarão disponíveis.

Para definir um diretório de trabalho (onde os documentos são salvos):

claude mcp add texflow -- uvx texflow-mcp ~/Documents/TeXFlow

Configure com o Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "texflow": {
      "command": "uvx",
      "args": ["texflow-mcp"]
    }
  }
}

Como funciona

O TeXFlow tem dois fluxos de entrada, ambos convergindo para o mesmo modelo de documento em memória:

1. Scaffold — document(action="create") cria um esqueleto de documento vazio. Adicione conteúdo com edit(action="insert").
2. Ingestão de Markdown — document(action="ingest", source="paper.md") analisa markdown no modelo. Refine o layout a partir daí.

O modelo salva automaticamente em disco como JSON. LaTeX é apenas um artefato de saída — você nunca edita .tex diretamente.

Ferramentas

Ferramenta	Propósito
document	Criar, ingerir markdown, mostrar estrutura, ler seções
layout	Colunas, fontes, papel, margens, cabeçalhos/rodapés, sumário
edit	Inserir, substituir, excluir, mover blocos (seção, parágrafo, figura, tabela, código, equação, lista, bruto)
render	Compilar para PDF, pré-visualizar página como PNG, exportar .tex
reference	Pesquisar comandos LaTeX, símbolos, pacotes, ajuda de erros
queue	Executar várias operações em uma única chamada

Cada resposta inclui um aviso de estado do fluxo de trabalho mostrando onde você está e o que fazer em seguida.

Exemplo de sessão

> document(action="create", title="My Paper", document_class="article")

> queue(operations=[
    {"tool": "edit", "action": "insert", "block_type": "section", "title": "Introduction", "level": 1},
    {"tool": "edit", "action": "insert", "content": "This paper explores...", "section": "Introduction"},
    {"tool": "edit", "action": "insert", "block_type": "section", "title": "Methods", "level": 1},
    {"tool": "layout", "font": "palatino", "columns": 2}
  ])

> render(action="compile")

Desenvolvimento

git clone https://github.com/aaronsb/texflow-mcp
cd texflow-mcp
uv sync
uv run pytest tests/ -v    # 222 tests
uv run texflow              # Start MCP server

Licença

MIT