Skip to main content
Glama

ABNT Copilot MCP

Servidor Model Context Protocol para Padronização, Auditoria e Conformidade Documental Acadêmica (ABNT/IBGE)

Python Version FastMCP ABNT Standard License: MIT Tests Coverage CI/CD


1. Apresentação e Justificativa Científica

A elaboração de manuscritos técnico-científicos no Brasil — compreendendo Trabalhos de Conclusão de Curso (TCC), dissertações de mestrado, teses de doutorado e artigos para periódicos — exige estrita consonância com o arcabouço normativo estabelecido pela Associação Brasileira de Normas Técnicas (ABNT) e pelas diretrizes de representação tabular do Instituto Brasileiro de Geografia e Estatística (IBGE).

Apesar da ampla disseminação de Grandes Modelos de Linguagem (LLMs) como assistentes na pesquisa acadêmica, observa-se uma taxa reincidente de desvios normativos e alucinações estruturais, tais como:

  1. Persistência de padrões revogados: Utilização de autoria em CAIXA ALTA dentro de parênteses, prática formalmente extinta pela atualização da ABNT NBR 10520:2023;

  2. Inconsistências bibliográficas cruzadas: Citações órfãs no corpo do texto e obras listadas nas referências finais que jamais foram citadas;

  3. Ausência de distinção tipográfica entre Tabelas e Quadros: Violação sistemática das Normas Tabulares do IBGE (1993), que estabelecem o fechamento aberto para dados quantitativos e fechado para representações conceituais;

  4. Desvios de impessoalidade: Frequente introdução de pronomes em primeira pessoa e asserções opinativas desprovidas de respaldo empírico ou bibliográfico.

O ABNT Copilot MCP (abnt-mcp) implementa uma camada de infraestrutura via Model Context Protocol (MCP), dotando ambientes de desenvolvimento, clientes de IA e pesquisadores de mecanismos programáticos de auditoria, formatação formal, consulta em bases científicas indexadas e compilação direta para PDF.


Related MCP server: TCC-MCP

2. Marco Regulatório e Normas Contempladas

O servidor foi arquitetado sob auditoria estrita das seguintes normas vigentes:

Norma / Documento

Ano / Edição

Escopo no Servidor MCP

ABNT NBR 14724

2011 (Em vigor)

Estrutura completa de trabalhos acadêmicos (elementos pré-textuais, textuais e pós-textuais), tipografia, paginação (3-3-2-2), ilustrações e equações/fórmulas numeradas.

ABNT NBR 6022

2018

Estrutura de artigos científicos em publicações periódicas (dispensa capa, folha de rosto e sumário; exige elementos textuais contínuos).

ABNT NBR 10520

2023 (Edição Vigente)

Sistema autor-data em caixa mista (Silva, 2023), citações diretas curtas (<=3 linhas) e longas (recuo de 4 cm, corpo 10, entrelinhas simples).

ABNT NBR 6023

2018 (Errata 2020)

Referências bibliográficas alinhadas à esquerda, destaque gráfico exclusivo no título principal e abreviatura padronizada de meses (maio sem ponto).

ABNT NBR 6024

2012

Numeração progressiva das seções de um documento; erradicação de ponto final após o indicativo numérico (1.1 e nunca 1.1.).

ABNT NBR 6027

2012

Apresentação e ordenação estrita de sumários a partir dos elementos textuais.

ABNT NBR 6028

2021

Resumos documentais em parágrafo único (150 a 500 palavras) e representação de palavras-chave separadas por ponto e vírgula.

Normas IBGE

1993

Normas de apresentação tabular (distinção física entre tabelas abertas e quadros fechados).


3. Arquitetura dos Pilares e Motor SDD (Spec-Driven Development)

O núcleo do sistema opera segregado em pilares modulares governados por especificações canônicas (specs/):

abnt-mcp/
├── specs/               # Especificações SDD Canônicas (Normas, Schema e Contratos MCP)
├── src/abnt_mcp/
│   └── pillars/
│       ├── diagnostics.py   # Pilar 1: Análise Estrutural (14724/6022), Tom Científico e Auditoria
│       ├── writing.py       # Pilar 2: Citações 2023, Referências 6023, Resumos e Figuras
│       ├── compiler.py      # Pilar 3: Compilação Multi-engine (Typst Rust Nativo e LaTeX)
│       ├── advisory.py      # Pilar 4: Crossref, SciELO, BibTeX por DOI e Simulação de Banca
│       └── spec.py          # Motor SDD: Manifesto Científico abnt.spec.json / SPEC.md

Pilar 1: Analisar & Diagnosticar

  • Validação Estrutural (NBR 14724 e NBR 6022): Valida a hierarquia documental para monografias (NBR 14724) e artigos científicos periódicos (NBR 6022), emitindo diagnósticos rastreáveis por IDs canônicos (NBR14724-R01, NBR14724-R02, NBR6022-R01, NBR6024-R01). Analisa fontes .tex, .md, .typ e arquivos compilados .pdf.

  • Auditoria Cruzada Citações vs. Referências: Identifica chaves órfãs no texto e entradas inertes no arquivo .bib, compatível com chamadas LaTeX (\cite, \citeonline, \apud, \citep), Markdown ([@ref], @ref) e Typst (@ref).

  • Análise de Impessoalidade e Rigor: Detecta pronomes de primeira pessoa, adjetivação hiperbólica, coloquialismos e parágrafos sem fundamentação.

Pilar 2: Redigir & Reformular

  • Formatador de Citações (NBR 10520:2023): Assegura autoria em caixa baixa-alta dentro de parênteses (Silva; Santos, 2023) e posicionamento do ponto final após os parênteses da indicação da fonte.

  • Formatador de Figuras e Ilustrações (NBR 14724): Gera a chamada textual obrigatória, identificação superior (Figura X – Título) e fonte no rodapé (Fonte: Elaborado pelo autor (Ano).) acoplada sem vãos.

  • Diferenciação Tabular IBGE (1993): Implementa o padrão canônico com laterais e divisórias abertas em Tabelas e fechamento em moldura completa para Quadros.

  • Formatador de Equações e Fórmulas (NBR 14724 item 5.9 e NBR14724-R04): Equações centralizadas e destacadas do texto com numeração consecutiva entre parênteses à margem direita, com explicação de variáveis iniciada por "onde:" sem recuo de parágrafo e entrelinha simples.

  • Gerador de Resumo (NBR 6028:2021): Síntese em parágrafo único de 150 a 500 palavras estruturada em contexto, objetivo, metodologia, resultados e conclusão.

Pilar 3: Testar & Compilar

  • Motor Tipográfico Nativo Embutido: Compilação ultra-rápida via biblioteca nativa em Rust (typst), entregando arquivos .pdf diretamente sem demandar a instalação de distribuições externas de LaTeX no sistema operacional.

  • Ciclo Completo abnTeX2: Suporte ao ciclo multi-pass (pdflatex -> bibtex -> pdflatex -> pdflatex) ou latexmk para resolução irrestrita de referências cruzadas [?].

  • Linter de Sintaxe Pré-compilação: Mapeamento de ambientes desbalanceados (\begin{...} sem \end{...}) e caracteres especiais desprotegidos com identificação da linha exata.

Pilar 4 & Motor SDD: Mentoria, Banca Examinadora e Especificação Científica

  • Escrita Acadêmica Orientada a Especificação (abnt.spec.json & SPEC.md): Formaliza em 3 camadas o Perfil Normativo, a Matriz Científica (OBJ-01, OBJ-02...) e os Capítulos Planejados, auditando automaticamente se cada objetivo específico prometido na Introdução foi desenvolvido no texto e respondido na Conclusão.

  • Recuperação de Literatura Primária: Consulta em tempo real às APIs abertas do Crossref e da rede SciELO, obtendo metadados completos (DOI, resumo, periódico e autores).

  • Consistência de BibTeX por DOI: Obtenção automática de metadados oficiais diretamente de doi.org com deduplicação nativa.

  • Simulador de Banca Avaliadora: Avaliação determinística do alinhamento entre os objetivos específicos da abnt.spec.json e os achados das Considerações Finais, formulando arguições personalizadas para objetivos pendentes.


4. Especificação Técnica das Interfaces MCP

O servidor expõe formalmente 19 ferramentas, 3 prompts orientados e 8 recursos canônicos sob a especificação do Model Context Protocol:

4.1. Ferramentas Operacionais (@mcp.tool)

Identificador

Parâmetros de Entrada

Descrição Formal

scaffold_academic_project

project_path: str, title: str, author: str, document_type: str = "tcc", format: "typst"|"latex"|"markdown" = "typst", sample_pdf_path: str?, logo_path: str?, ...

Inicializa a árvore do projeto com injeção dinâmica dos 9 elementos pré-textuais e listas reativas, aprendendo o perfil e brasão/logotipo de um PDF modelo.

init_research_spec

project_path: str, title: str, research_problem: str, general_objective: str, specific_objectives: list, methodology_summary: str, sample_pdf_path: str?, logo_path: str?, ...

Inicializa o manifesto científico SDD (abnt.spec.json e SPEC.md) em 3 camadas no projeto.

audit_research_spec

project_path: str, spec_path: str?

Audita o manuscrito contra abnt.spec.json, validando objetivos (OBJ-XX), regras da instituição, ilustrações/tabelas, prontidão (submission_readiness) e salvando relatórios em .abnt-mcp/.

simulate_banca

project_path: str

Simula arguição de banca examinadora com notas por eixo e cobrança direta de objetivos específicos pendentes.

check_structure

project_path: str, standard: str = "ABNT_14724"

Analisa a conformidade dos elementos pré, textuais e pós-textuais (NBR 14724 e NBR 6022) de fontes ou PDFs.

audit_illustrations_and_tables

project_path: str

Audita figuras, tabelas e quadros (chamada prévia obrigatória, Fonte:, caminhos de imagem, sequência e distinção Tabela vs Quadro IBGE).

validate_citations

project_path: str, bib_path: str?

Auditoria cruzada entre texto e referências, apontando citações órfãs e violações de caixa alta.

analyze_tone

text: str

Mensura o índice de rigor científico (0-100), sinalizando primeira pessoa e coloquialismos.

format_citation

authors: list[str], year: str|int, style: str, quote_type: str, page: str?, quote_text: str?

Formatação de citações diretas (curtas/longas) e indiretas sob a NBR 10520:2023.

format_reference

entry_type: str, title: str, year: str|int, authors: list?, journal_name: str?, publisher: str?, ...

Elaboração de referências conforme NBR 6023:2018 com destaque exclusivo no título principal.

format_figure

image_path: str, caption: str, source: str, figure_number: int|str

Gera snippets para inserção formal de ilustrações (topo, centro, base com fonte e chamada textual).

format_table

title: str, headers: list[str], rows: list[list[str]], source: str, category: "tabela"|"quadro"

Formatação de tabelas (Normas IBGE, laterais abertas) ou quadros (ABNT, bordas fechadas).

format_equation

expression: str, equation_number: int|str = 1, variable_definitions: list?|str?, label: str?, target_format: str = "typst"

Formatação de equações matemáticas centralizadas, numeradas à direita e variáveis sem recuo (NBR 14724 item 5.9 e NBR14724-R04).

generate_academic_resumo

context: str, objective: str, methodology: str, results: str, conclusion: str, keywords: list[str], language: "pt"|"en"

Redação de resumo ou abstract canônico contínuo (NBR 6028) com validação de extensão.

search_academic_papers

query: str, source: "all"|"crossref"|"scielo", limit: int = 5

Recuperação de artigos indexados com DOI, resumo e metadados estruturados.

fetch_bibtex_by_doi

doi: str, bib_file: str?

Recupera a entrada BibTeX oficial via negociação de conteúdo e anexa ao .bib sem duplicatas.

clean_bibtex_file

bib_path: str, output_path: str?

Higienização de arquivos BibTeX, conversão para UTF-8 estrito e normalização de meses ABNT.

compile_tcc

project_path: str, engine: "auto"|"typst"|"latex"|"markdown"

Compilação direta para PDF no padrão ABNT com diagnóstico de erros e indicação de linhas.

read_pdf_section

pdf_path: str, pages: list[int]?, start_page: int?, end_page: int?

Extração seletiva de texto e contagem lexical de documentos PDF para fins de auditoria.

4.2. Prompts de Orientação e Revisão (@mcp.prompt)

  • revisar_capitulo(texto, foco): Instruções parametrizadas para parecer técnico contendo nota de rigor científico, diagnóstico de impessoalidade e proposta de reformulação.

  • formatar_citacao(trecho, autor, ano, pagina, tipo): Geração de blocos canônicos de citação para Markdown, LaTeX (abntex2) e Typst.

  • simular_banca(projeto_path): Análise de vulnerabilidades metodológicas, conformidade com a introdução e as principais perguntas de arguição para defesa oral.

4.3. Recursos Canônicos Integrados (@mcp.resource)

  • abnt://guia/citacoes: Síntese executiva da ABNT NBR 10520:2023.

  • abnt://guia/estrutura: Checklist completo da NBR 14724:2011 e NBR 6024:2012.

  • abnt://guia/referencias: Matriz tipológica de referências bibliográficas da NBR 6023:2018.

  • abnt://guia/sdd: Guia de Escrita Acadêmica Orientada a Especificações (SDD).

  • abnt://template/latex: Template funcional completo para LaTeX configurado com abnTeX2.

  • abnt://template/typst: Template funcional moderno em Typst com geometria física 3-3-2-2.

  • abnt://template/markdown: Template Pandoc com cabeçalho YAML e metadados para CSL.

  • abnt://template/spec: Template JSON em 3 camadas do manifesto abnt.spec.json.


5. Instalação e Execução

O servidor é compatível com Python >=3.10 e preparado para execução direta através do gerenciador de ambientes uv:

Execução Instantânea via uvx (Zero Configuração)

# Execução direta da versão mais recente via GitHub:
uvx --from git+https://github.com/PedroSmaxY/abnt-mcp abnt-mcp

# Ou via PyPI:
uvx abnt-mcp

Instalação via Gerenciador de Pacotes

# Utilizando uv:
uv pip install abnt-mcp

# Utilizando pip tradicional:
pip install abnt-mcp

# Execução do servidor MCP (transporte stdio padrão):
abnt-mcp

6. Configuração nos Ambientes de Pesquisa

Claude Desktop

Edite o arquivo de configuração do Claude Desktop (claude_desktop_config.json):

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

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

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

Cursor IDE

No diretório raiz da sua pesquisa ou globalmente nas preferências do Cursor, configure .cursor/mcp.json:

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

Google Antigravity / Gemini CLI

No arquivo de registro de servidores MCP (mcp_config.json):

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

7. Garantia de Qualidade, Cobertura e CI/CD

A integridade do código-fonte e a fidelidade às normas técnicas são aferidas de forma contínua através de uma suíte automatizada no pytest, com auditoria de cobertura de código via pytest-cov e esteira de integração contínua (GitHub Actions CI/CD) multiplataforma.

7.1 Execução da Suíte de Testes

# Execução da suíte completa com análise de cobertura
uv run pytest -v --cov=abnt_mcp --cov-report=term-missing
============================= 83 passed in 2.40s =============================
tests/test_advisory.py (4 testes)     -> Consulta Crossref/SciELO, DOI e Simulador de Banca
tests/test_compiler.py (5 testes)     -> Linter de ambientes, diagnóstico rico de erros Typst e engines
tests/test_diagnostics.py (7 testes)  -> Estrutura NBR 14724, auditoria de citações, linter NBR 10520 e tom científico
tests/test_edge_cases.py (23 testes)  -> Casos de borda (paginação NBR 14724, autores compostos, localizadores, IBGE vs ABNT)
tests/test_parsers.py (10 testes)     -> Extratores LaTeX/MD/Typst, linter/autofix NBR10520-R05 e extração de PDF
tests/test_sdd.py (16 testes)         -> Trava Anti-Drift SDD, CHANGELOG/SemVer, scaffolding, PDF/logo institucional e relatórios
tests/test_server.py (6 testes)       -> Registro e execução de tools, prompts e resources
tests/test_writing.py (12 testes)     -> Citações 2023, Referências 6023, Resumo, Figuras, Tabelas e Equações

7.2 Relatório de Cobertura de Código

A suíte assegura 87% de cobertura global no núcleo do sistema:

Módulo / Camada

Declarações

Cobertura

Escopo de Garantia

abnt_mcp.config

32

100%

Catálogo SDD (NORMATIVE_RULES), regexes normativas, meses ABNT e léxico

abnt_mcp.models

198

100%

Esquemas Pydantic e modelos de 3 camadas (ResearchSpec)

abnt_mcp.parsers.citations

115

97%

Extração, auditoria e linter/autofix de citações em LaTeX, MD e Typst

abnt_mcp.pillars.diagnostics

279

91%

Validação NBR 14724 / NBR 6022, auditoria de .bib, tom científico e paginação

abnt_mcp.pillars.spec

383

91%

Motor SDD (abnt.spec.json, SPEC.md, scaffolding institucional e auditoria)

abnt_mcp.pillars.writing

242

88%

NBR 10520:2023, NBR 6023:2018, NBR 6028, tabelas IBGE, figuras e equações

abnt_mcp.server

121

88%

Protocolo FastMCP (17 tools, 3 prompts, 9 resources)

abnt_mcp.parsers.pdf_reader

248

83%

Auditoria forense de paginação NBR 14724, extração visual e de logos

abnt_mcp.pillars.advisory

153

82%

Consultas Crossref, SciELO, BibTeX por DOI e banca integrada ao SDD

abnt_mcp.parsers.bibtex

92

80%

Sanitização, normalização e deduplicação de entradas

abnt_mcp.pillars.compiler

261

70%

Compilação nativa Typst, LaTeX abnTeX2, diagnóstico de erros e sugestões

Total do Ecossistema

2158

87%

83 testes aprovados

7.3 Esteira de Integração Contínua (GitHub Actions)

A cada push ou pull request submetido à branch main, o pipeline automatizado (.github/workflows/ci.yml) valida o projeto em matriz cruzada:

  • Sistemas Operacionais: Ubuntu Linux (ubuntu-latest) e Windows Server (windows-latest).

  • Versões do Interpretador Python: 3.10, 3.11 e 3.12.

  • Validações Automatizadas: Resolução determinística com uv sync, execução completa dos 69 testes (incluindo trava anti-drift SDD) com relatório XML de cobertura e teste de integridade da CLI (abnt-mcp --help).


8. Como Citar este Projeto

Caso utilize o ABNT Copilot MCP no desenvolvimento de sua pesquisa, dissertação, tese ou artigo científico, cite o repositório em conformidade com a ABNT NBR 6023:2018:

NOVAIS, Pedro Henrique da Silva. ABNT Copilot MCP: servidor Model Context Protocol para padronização e conformidade acadêmica. Versão 0.1.0. GitHub, 2026. Disponível em: https://github.com/PedroSmaxY/abnt-mcp. Acesso em: 24 out. 2026.

Entrada BibTeX:

@software{novais2026abntmcp,
  author       = {Novais, Pedro Henrique da Silva},
  title        = {ABNT Copilot MCP: Servidor Model Context Protocol para Padronização e Conformidade Acadêmica},
  version      = {0.1.0},
  year         = {2026},
  publisher    = {GitHub},
  url          = {https://github.com/PedroSmaxY/abnt-mcp}
}

9. Governança SDD, Licença e Contribuições

Este projeto é disponibilizado sob a licença de código aberto MIT e regido por Desenvolvimento Orientado a Especificações (Spec-Driven Development — SDD).

Antes de propor alterações ou submeter um Pull Request, consulte obrigatoriamente:

  • CONTRIBUTING.md: Protocolo técnico-científico de colaboração, convenção de branches, commits semânticos e matriz de rastreabilidade.

  • AGENTS.md & CLAUDE.md: Diretrizes mandatórias de sincronização de especificações (specs/) para agentes de Inteligência Artificial.

  • specs/: Catálogo normativo canônico (01-normative-catalog.spec.md), especificação do manifesto científico (02-research-spec-schema.spec.md) e contratos de ferramentas MCP (03-mcp-tools-contract.spec.md).

Available Tools

19 tools
analyze_toneAnalyze ToneA

Analisa o rigor científico e a impessoalidade da escrita acadêmica:

  • Detecta uso de 1ª pessoa ('eu fiz', 'nós achamos', 'meu trabalho').

  • Sinaliza juízos de valor sem comprovação ('claramente', 'obviamente', 'sem dúvida').

  • Encontra expressões coloquiais e parágrafos desprovidos de citação/fundamentação.

  • Sugere reformulações para voz passiva sintética e terceira pessoa.

Inputs: text (required). Returns: object

audit_illustrations_and_tablesAudit Illustrations And TablesA

Audita figuras, tabelas e quadros do projeto segundo a ABNT NBR 14724 (item 5.8) e IBGE (1993):

  • Detecta figuras, tabelas ou quadros sem chamada textual prévia obrigatória (NBR14724-R03).

  • Aponta ausência de 'Fonte:' na parte inferior (NBR14724-R03).

  • Verifica se todos os arquivos de imagem referenciados existem fisicamente no projeto.

  • Diagnostica numeração fora de sequência e confusão conceitual entre Tabela e Quadro (IBGE1993-R01).

Inputs: project_path (required). Returns: object

audit_research_specAudit Research SpecB

Audita o manuscrito acadêmico contra o manifesto 'abnt.spec.json' (Spec-Driven Academic Writing):

  • Verifica se cada objetivo específico (OBJ-01, OBJ-02...) foi discutido no texto e respondido na Conclusão.

  • Confere a presença dos capítulos planejados e a meta mínima de referências no .bib.

  • Reporta violações com IDs canônicos de regra (NBR14724-R01, NBR6022-R01, NBR10520-R01, NBR6024-R01).

Inputs: project_path (required), spec_path. Returns: object

check_structureCheck StructureA

Valida a conformidade da estrutura acadêmica conforme a ABNT NBR 14724:2011:

  • Verifica elementos pré-textuais obrigatórios (capa, folha de rosto, resumo, abstract, sumário).

  • Não penaliza a ausência de listas opcionais (figuras, tabelas, siglas).

  • Verifica elementos textuais e pós-textuais (referências).

  • Diagnostica violações de numeração progressiva de seções da NBR 6024 (ex: ponto indevido no final).

Inputs: project_path (required), standard. Returns: object

clean_bibtex_fileClean Bibtex FileB

Higieniza e normaliza um arquivo BibTeX segundo a ABNT NBR 6023:2018:

  • Converte acentos LaTeX obsoletos para UTF-8 nativo estrito.

  • Normaliza abreviação de meses (incluindo a regra de 'maio' sem ponto).

  • Valida campos obrigatórios por tipo de entrada sem corromper ou perder chaves.

Inputs: bib_path (required), output_path. Returns: object

compile_tccCompile TccB

Compila o projeto acadêmico para PDF utilizando LaTeX (abnTeX2 com ciclo multi-pass para evitar [?]), Typst ou Pandoc com --citeproc. Inclui pré-checagem de erros de sintaxe e diagnóstico amigável.

Inputs: project_path (required), engine. Returns: object

fetch_bibtex_by_doiFetch Bibtex By DoiB

Recupera a entrada BibTeX oficial correspondente a um DOI via negociação de conteúdo e opcionalmente anexa ao arquivo .bib do projeto sem duplicar chaves ou DOIs.

Inputs: doi (required), bib_file. Returns: object

format_citationFormat CitationB

Formata chamadas de citação rigorosamente conforme a NBR 10520:2023:

  • Sobrenomes em caixa mista/baixa dentro dos parênteses (ex: '(Silva, 2023)' e nunca '(SILVA, 2023)').

  • Citações diretas curtas (<=3 linhas): entre aspas com ponto final APÓS os parênteses.

  • Citações diretas longas (>3 linhas): bloco recuado a 4 cm, fonte 10, espaçamento simples e sem aspas.

Inputs: year (required), authors (required), page, style, +3 more. Returns: object

format_equationFormat EquationA

Formata equações e fórmulas matemáticas segundo a ABNT NBR 14724 (item 5.9 e regra NBR14724-R04):

  • Equações centralizadas e destacadas do texto com numeração consecutiva entre parênteses à margem direita.

  • Definição das variáveis ('onde:' ou 'em que:') sem recuo de parágrafo (first-line-indent: 0cm).

  • Blindagem contra quebras órfãs de página em Typst via #block(breakable: false).

  • Gera snippets prontos para Typst, LaTeX e Markdown.

Inputs: expression (required), label, target_format, equation_number, +1 more. Returns: object

format_figureFormat FigureA

Formata uma figura/imagem no padrão da ABNT NBR 14724:

  • Identificação no topo ('Figura X – Título').

  • Imagem centralizada com caminho no computador.

  • Indicação da fonte obrigatória no rodapé (default dinâmico com ano corrente).

  • Fornece exemplo da chamada obrigatória no texto e snippets prontos em Markdown, LaTeX e Typst.

Inputs: caption (required), image_path (required), source, figure_number, +1 more. Returns: object

format_referenceFormat ReferenceC

Formata uma referência bibliográfica conforme a ABNT NBR 6023:2018:

  • Alinhamento à margem esquerda.

  • Destaque em negrito/itálico aplicado exclusivamente ao título principal (nunca ao subtítulo).

  • Abreviação correta de meses em língua portuguesa.

Inputs: year (required), title (required), entry_type (required), url, +11 more. Returns: object

format_tableFormat TableB

Formata dados no padrão das Normas Tabulares do IBGE (1993) e ABNT NBR 14724:

  • 'tabela': para dados numéricos/estatísticos com bordas laterais ABERTAS (padrão IBGE).

  • 'quadro': para dados textuais/qualitativos com bordas fechadas em moldura completa.

  • Gera snippets em Markdown, LaTeX (booktabs para tabelas) e Typst.

Inputs: rows (required), title (required), headers (required), source, +2 more. Returns: object

generate_academic_resumoGenerate Academic ResumoB

Gera um Resumo (em português) ou Abstract (em inglês) na estrutura canônica da NBR 6028:2021:

  • Parágrafo único contínuo.

  • Verbos na 3ª pessoa e linguagem impessoal concisa.

  • Avalia a faixa de palavras (150 a 500 para TCC/teses).

  • Formata palavras-chave separadas por ponto e vírgula e terminadas em ponto.

Inputs: context (required), results (required), keywords (required), objective (required), +3 more. Returns: object

init_research_specInit Research SpecC

Inicializa o manifesto de Especificação Científica (SDD) 'abnt.spec.json' e 'SPEC.md' no projeto:

  • Camada 1: Perfil Normativo e Institucional (com aprendizado automático de PDF modelo da faculdade e cópia de logo).

  • Camada 2: Matriz Científica rastreável (Problema, Objetivo Geral e Objetivos Específicos OBJ-XX).

  • Camada 3: Capítulos planejados com metas mínimas de extensão e citações.

Inputs: title (required), project_path (required), research_problem (required), general_objective (required), +12 more. Returns: object

read_pdf_sectionRead Pdf SectionB

Extrai o texto e dados estatísticos de um PDF acadêmico para fins de revisão e auditoria. Permite selecionar páginas específicas ou intervalos (1-indexado).

Inputs: pdf_path (required), pages, end_page, start_page. Returns: object

scaffold_academic_projectScaffold Academic ProjectB

Inicializa a árvore completa de diretórios e arquivos de um projeto acadêmico (TCC, Dissertação, Tese ou Artigo):

  • Cria diretórios capitulos/, figuras/, tabelas/, anexos/, apendices/ e .abnt-mcp/.

  • Se sample_pdf_path for fornecido, extrai automaticamente o padrão da universidade (cabeçalho da capa, preâmbulo, seções exigidas e brasão/logo da página 1).

  • Se logo_path for fornecido, copia o arquivo de logotipo para figuras/logo_instituicao.* e referencia-o na capa.

  • Gera abnt.spec.json, SPEC.md, referencias.bib e o arquivo principal (main.typ, main.tex ou main.md).

Inputs: title (required), author (required), project_path (required), city, +12 more. Returns: object

search_academic_papersSearch Academic PapersB

Busca artigos científicos recentes nas bases abertas Crossref e SciELO por DOI, título e resumo. Útil para embasar fundamentação teórica e capítulos de revisão bibliográfica.

Inputs: query (required), limit, source. Returns: result

simulate_bancaSimulate BancaB

Executa a simulação de banca examinadora (TCC/Dissertação/Tese/Artigo):

  • Avalia alinhamento entre Introdução, Objetivos Específicos (via abnt.spec.json se presente) e Conclusão.

  • Calcula notas por eixo e formula perguntas críticas de arguição para a defesa oral.

Inputs: project_path (required). Returns: object

validate_citationsValidate CitationsA

Realiza auditoria cruzada completa entre o texto e as referências:

  • Suporta LaTeX (\cite, \citeonline, \apud, \citep), Markdown ([@ref]) e Typst (@ref).

  • Detecta citações órfãs (citadas no texto, mas ausentes no .bib).

  • Aponta entradas do .bib nunca citadas no texto.

  • Identifica citações com sobrenome em CAIXA ALTA violando a NBR 10520:2023.

Inputs: project_path (required), bib_path. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 19 tools

    Disambiguation4/5

    Most tools target clearly distinct ABNT tasks: citation formatting, reference formatting, figure/table/equation formatting, compilation, auditing, scaffolding, and search. The only mild ambiguity is among the audit-style tools (audit_research_spec, check_structure, audit_illustrations_and_tables, simulate_banca), but their scopes and descriptions are sufficiently differentiated.

    Naming Consistency5/5

    All 19 tools use consistent snake_case naming and nearly all follow a predictable verb_object pattern. Portuguese/English noun mixing appears in labels like generate_academic_resumo and compile_tcc, but the naming convention itself remains stable and readable.

    Tool Count4/5

    At 19 tools the server is on the heavy side, but the breadth of ABNT academic-writing work justifies many specialized operations. Each tool maps to a distinct task, so the count is reasonable rather than bloated.

    Completeness4/5

    The surface covers core workflows: project scaffolding, BibTeX retrieval/cleanup, citation and reference formatting, structural audits, illustration/table checks, tone analysis, compilation, and paper search. Minor gaps remain around automatic remediation of audit findings and direct document-editing operations, but the main academic-writing lifecycle is well covered.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for academic writing and review of Brazilian undergraduate theses (TCC) following ABNT standards. Enables article search, PDF reading, citation management, assisted writing, review, validation, and PDF compilation.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides local academic literature search and writing support by querying OpenAlex, arXiv, and Crossref, downloading open-access PDFs, extracting IMRaD sections, and appending BibTeX references.
      4
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables auditing of every citation in a LaTeX or Markdown manuscript (English or Portuguese) against the actual passage in the cited PDF, verifying quotes literally, fetching sources from local folders, Zotero, arXiv and open-access APIs, and flagging bibliography problems such as retractions or missing DOIs. It also drafts and safely applies approved rewrites or new evidence-backed paragraphs in the .tex file with validation, encoding preservation and backups.
      19
      MIT