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:
{
"mcpServers": {
"neomath": {
"command": "C:/Caminho/para/neomath-mcp.exe",
"env": { "NEOMATH_MCP_ROOTS": "C:/Users/voce/Documents/Equacoes" }
}
}
}Claude Code
claude mcp add neomath --env NEOMATH_MCP_ROOTS=C:/Users/voce/Documents/Equacoes -- C:/Caminho/para/neomath-mcp.exeCursor 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(ouwriting …) 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 |
{ "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:
neoscript_docs_listar: o mapa das seções e de todas as funções.neoscript_docs_ler: uma seção ou uma função em Markdown.neoscript_docs_buscar: procura um termo.run_neoscript: roda o script comfolders(pastas liberadas),timeout_secondsememory_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.