API, CLI e MCP

Servidor MCP

Deja que modelos de IA generen, conviertan y comprueben ecuaciones y estructuras químicas mediante neomath-mcp, sin abrir la aplicación y sin abrir puertos de red.

En esta página

Configurar en el cliente
Carpetas permitidas
Herramientas de ecuaciones
Opciones comunes (options)
Química
NeoScript por la IA
Recursos y prompts

neomath-mcp deja que modelos de IA (Claude, GPT, Gemini, modelos locales y cualquier cliente que hable MCP) generen, conviertan y abran ecuaciones y trabajen con química de forma precisa y sin abrir la aplicación.

Es un programa aparte, un único ejecutable, sin instalación.
Habla MCP por stdio: el cliente abre el programa y conversa por la entrada y salida estándar. No abre puertos de red.
Los resultados son idénticos a los de la aplicación, la línea de comandos y la API.

Configurar en el cliente#

Claude Desktop

En claude_desktop_config.json:

JSON

{
  "mcpServers": {
    "neomath": {
      "command": "C:/Ruta/a/neomath-mcp.exe",
      "env": { "NEOMATH_MCP_ROOTS": "C:/Users/tu/Documents/Ecuaciones" }
    }
  }
}

Claude Code

Terminal

claude mcp add neomath --env NEOMATH_MCP_ROOTS=C:/Users/tu/Documents/Ecuaciones -- C:/Ruta/a/neomath-mcp.exe

Cursor y VS Code

Usa el mismo formato de Claude Desktop (command y env) en .cursor/mcp.json o en .vscode/mcp.json (en VS Code, la clave es servers).

Cualquier otro cliente: comando neomath-mcp, transporte stdio, sin argumentos. En JSON en Windows, usa / o \\ en las rutas.

Carpetas permitidas#

NEOMATH_MCP_ROOTS define dónde puede leer y escribir el servidor: carpetas separadas por ; en Windows y : en los demás sistemas. Sin la variable, solo la carpeta del usuario y la carpeta temporal. * permite cualquier carpeta (no recomendado).

Solo rutas absolutas.
Nunca sobrescribe un archivo existente sin overwrite: true; un lote omite los que ya existen.
Los enlaces simbólicos se resuelven antes de la comprobación.
Una petición fuera de las carpetas vuelve con el mensaje reading outside the allowed folders is blocked (o writing …) y la lista de carpetas aceptadas.

Herramientas de ecuaciones#

Herramienta	Qué hace	¿Escribe?
`render_equation`	LaTeX o MathML a EPS, SVG o PNG; el PNG vuelve como imagen para que el modelo lo compruebe	solo con `output_path`
`check_equation`	valida y devuelve MathML normalizado, LaTeX, tamaño y correcciones	no
`latex_to_mathml`, `mathml_to_latex`	conversiones de texto	no
`normalize_mathml`	limpia MathML que viene de Word y la web	no
`open_eps`	recupera MathML, LaTeX, formato y preferencias de un EPS, SVG o PNG generado por NeoMath	no
`batch_render`	hasta 2000 ecuaciones por llamada, un archivo cada una	en la carpeta indicada
`render_folder`	carpeta de `.txt` de MathML a EPS, con informe	en la salida
`convert_files`	convierte carpetas de archivos de Neo; nunca modifica los originales	en la salida
`inspect_preferences`, `create_preferences`	lee y crea preferencias	solo con `output_path`
`equation_layout`	geometría exacta de cada glifo y trazo	no
`extract_docx_equations`	ecuaciones de un `.docx`	solo con `output_dir`
`restyle_folder`, `undo_restyle`, `list_restyle_backups`	estilo por lotes; simulación de forma predeterminada	con copia de seguridad
`list_fonts`, `neomath_info`	fuentes, versión, formatos y consejos	no

Opciones comunes (`options`)#

Opción	Efecto
`color`, `color_cmyk`, `color_everything`	color de toda la ecuación, en RGB o CMYK
`preferences_file`, `preferences_text`	estilo (fuentes, tamaños y espaciados)
`normalize`, `multiplication`, `thousands_separator`, `function_application`	limpieza del MathML
`title`, `date`, `fix_symbol_metrics`	título, fecha y medida de símbolos

Química#

Las herramientas chem_* trabajan con química. La estructura entra en input: un SMILES o el documento CML, MOL o SDF.

Herramienta	Qué hace
`chem_read_molecule`	fórmula, masa molar, carga, anillos, composición y descripción accesible; `explain: true` da el porqué
`chem_properties`	solo las propiedades
`chem_convert`	entre `smiles`, `cml`, `mol`, `sdf`, `json` y `svg`
`chem_render`	dibujo 2D en SVG o PNG, con estilo (`style.preset`: `default`, `acs`, `rsc`, `latex`, `dark`)
`chem_export`	escribe la molécula en un archivo
`chem_report`	informe en Markdown para trabajos escolares
`chem_validate`	valencia, partes desconectadas, carga y átomos superpuestos
`chem_reaction_scheme`	esquema de reacción en texto, dibujado o convertido
`chem_balance`	balanceo y estequiometría, con reactivo limitante y rendimiento
`chem_element`	datos de un elemento; `all` devuelve la tabla compacta
`chem_catalog`, `chem_batch_convert`	catálogo de estructuras y conversión de carpetas

JSON

{ "name": "chem_render", "arguments": { "input": "CC(=O)O", "format": "png", "dpi": 150, "white_background": true } }

NeoScript por la IA#

Cuatro herramientas permiten que la IA escriba scripts correctos sin adivinar la API:

neoscript_docs_listar: el mapa de las secciones y de todas las funciones.
neoscript_docs_ler: una sección o una función en Markdown.
neoscript_docs_buscar: busca un término.
run_neoscript: ejecuta el script con folders (carpetas permitidas), timeout_seconds y memory_mb, y devuelve la salida, el valor y el error con la línea.

Recursos y prompts#

Recurso	Contenido
`neochem://tabela-periodica`	los 118 elementos en JSON
`neochem://elemento/<Z, símbolo o nombre>`	datos completos de un elemento
`neochem://catalogo`	catálogo de estructuras listas
`neomath://quimica-latex`	comandos de química que acepta NeoMath
`neomath://api-http`	especificación OpenAPI de la API local

Prompts listos: converter_docx, revisar_equacoes y prova_estequiometria. En Claude Code, por ejemplo, /mcp__neomath__revisar_equacoes.