Pular para o conteúdo
Servidor MCP
API, CLI e MCP

Servidor MCP

Deixe modelos de IA gerarem, converterem e conferirem equações e estruturas químicas pelo neomath-mcp, sem abrir o aplicativo e sem abrir porta de rede.

Nesta página

O neomath-mcp deixa modelos de IA (Claude, GPT, Gemini, modelos locais e qualquer cliente que fale MCP) gerar, converter e abrir equações e trabalhar com química de forma precisa e sem abrir o aplicativo.

  • É um programa separado, um único executável, sem instalação.
  • Fala MCP por stdio: o cliente abre o programa e conversa pela entrada e saída padrão. Não abre porta de rede.
  • Os resultados são idênticos aos do aplicativo, da linha de comando e da API.

Configurar no cliente#

Claude Desktop

Em claude_desktop_config.json:

JSON
{
  "mcpServers": {
    "neomath": {
      "command": "C:/Caminho/para/neomath-mcp.exe",
      "env": { "NEOMATH_MCP_ROOTS": "C:/Users/voce/Documents/Equacoes" }
    }
  }
}

Claude Code

Terminal
claude mcp add neomath --env NEOMATH_MCP_ROOTS=C:/Users/voce/Documents/Equacoes -- C:/Caminho/para/neomath-mcp.exe

Cursor e VS Code

Use o mesmo formato do Claude Desktop (command e env) em .cursor/mcp.json ou em .vscode/mcp.json (no VS Code, a chave é servers).

Qualquer outro cliente: comando neomath-mcp, transporte stdio, sem argumentos. Em JSON no Windows, use / ou \\ nos caminhos.

Pastas permitidas#

NEOMATH_MCP_ROOTS define onde o servidor pode ler e gravar: pastas separadas por ; no Windows e : nos demais sistemas. Sem a variável, só a pasta do usuário e a pasta temporária. * libera qualquer pasta (não recomendado).

  • Só caminhos absolutos.
  • Nunca sobrescreve um arquivo existente sem overwrite: true; um lote pula os que já existem.
  • Links simbólicos são resolvidos antes da conferência.
  • Um pedido fora das pastas volta com a mensagem reading outside the allowed folders is blocked (ou writing …) e a lista das pastas aceitas.

Ferramentas de equações#

Ferramenta O que faz Grava?
render_equation LaTeX ou MathML para EPS, SVG ou PNG; o PNG volta como imagem para o modelo conferir só com output_path
check_equation valida e devolve MathML normalizado, LaTeX, tamanho e correções não
latex_to_mathml, mathml_to_latex conversões de texto não
normalize_mathml limpa MathML vindo do Word e da web não
open_eps recupera MathML, LaTeX, formato e preferências de um EPS, SVG ou PNG gerado pelo NeoMath não
batch_render até 2000 equações por chamada, um arquivo cada na pasta indicada
render_folder pasta de MathML .txt para EPS, com relatório na saída
convert_files converte pastas de arquivos da Neo; nunca altera os originais na saída
inspect_preferences, create_preferences lê e cria preferências só com output_path
equation_layout geometria exata de cada glifo e traço não
extract_docx_equations equações de um .docx só com output_dir
restyle_folder, undo_restyle, list_restyle_backups estilo em lote; simulação por padrão com backup
list_fonts, neomath_info fontes, versão, formatos e dicas não

Opções comuns (options)#

Opção Efeito
color, color_cmyk, color_everything cor de toda a equação, em RGB ou CMYK
preferences_file, preferences_text estilo (fontes, tamanhos e espaçamentos)
normalize, multiplication, thousands_separator, function_application limpeza do MathML
title, date, fix_symbol_metrics título, data e medida de símbolos

Química#

As ferramentas chem_* trabalham com química. A estrutura entra em input: um SMILES ou o documento CML, MOL ou SDF.

Ferramenta O que faz
chem_read_molecule fórmula, massa molar, carga, anéis, composição e descrição acessível; explain: true dá o porquê
chem_properties só as propriedades
chem_convert entre smiles, cml, mol, sdf, json e svg
chem_render desenho 2D em SVG ou PNG, com estilo (style.preset: default, acs, rsc, latex, dark)
chem_export grava a molécula num arquivo
chem_report relatório em Markdown para trabalhos escolares
chem_validate valência, partes desconectadas, carga e átomos sobrepostos
chem_reaction_scheme esquema de reação em texto, desenhado ou convertido
chem_balance balanceamento e estequiometria, com reagente limitante e rendimento
chem_element dados de um elemento; all devolve a tabela compacta
chem_catalog, chem_batch_convert catálogo de estruturas e conversão de pastas
JSON
{ "name": "chem_render", "arguments": { "input": "CC(=O)O", "format": "png", "dpi": 150, "white_background": true } }

NeoScript pela IA#

Quatro ferramentas deixam a IA escrever scripts certos sem adivinhar a API:

  1. neoscript_docs_listar: o mapa das seções e de todas as funções.
  2. neoscript_docs_ler: uma seção ou uma função em Markdown.
  3. neoscript_docs_buscar: procura um termo.
  4. run_neoscript: roda o script com folders (pastas liberadas), timeout_seconds e memory_mb, e devolve a saída, o valor e o erro com a linha.

Recursos e prompts#

Recurso Conteúdo
neochem://tabela-periodica os 118 elementos em JSON
neochem://elemento/<Z, símbolo ou nome> dados completos de um elemento
neochem://catalogo catálogo de estruturas prontas
neomath://quimica-latex comandos de química aceitos pelo NeoMath
neomath://api-http especificação OpenAPI da API local

Prompts prontos: converter_docx, revisar_equacoes e prova_estequiometria. No Claude Code, por exemplo, /mcp__neomath__revisar_equacoes.