James Valencia
← Proyectos

2026 — presente

Servidor MCP para SIIGO Pyme

Autor / Open Source

Impacto

Tareas contables que antes requerían abrir SIIGO Pyme a mano y navegar su CLI se vuelven operaciones que un agente de IA ejecuta directo, con la misma seguridad de confirmación explícita que tendría una persona antes de escribir en la contabilidad.

TypeScriptNode.jsModel Context ProtocolWindows COM

El problema

SIIGO Pyme, el software contable (marca de terceros, no afiliado), expone sus funciones a través del CLI EXCELSIIGO.exe: 47 funciones que hoy requieren abrir el programa a mano y navegar su interfaz. Exponer esas 47 funciones como 47 tools MCP independientes tiene un costo medido, no estimado: cada esquema viaja en cada invocación del modelo, y eso le costaba a cada llamada ~35.000 tokens — 140.116 caracteres solo en tools/list.

El enfoque

El servidor colapsa las 47 funciones detrás de una sola tool siigo_run_function, con autodescubrimiento de instalaciones y empresas y resultados de Excel ya parseados a JSON. Eso bajó el costo de esquema a 8.927 caracteres — 94% menos, configurable con una variable de entorno. El costo de esa compresión: al unificar 47 tools en una se pierde poder marcar cada función como destructiva por separado, así que cualquier operación de escritura (PUSH*, que modifica la contabilidad real) exige un flag explícito confirmarEscritura: true, porque el servidor no puede deshacer una importación. El proyecto también documenta honestamente un modo de fallo que su propia capa no puede eliminar: el CLI de SIIGO puede aceptar un parámetro mal formateado, registrarlo como error interno y terminar con código de salida 0 — un error indistinguible de un éxito a nivel de proceso, y la única forma en que el servidor puede devolver datos equivocados. Como SIIGO genera los archivos Excel vía COM, además necesita una sesión de escritorio activa: no puede correr como servicio de Windows, por SSH sin sesión, ni en contenedor.

Resultado

Tareas contables que antes requerían abrir SIIGO Pyme a mano y navegar su CLI se vuelven operaciones que un agente de IA ejecuta directo, con la misma seguridad de confirmación explícita que tendría una persona antes de escribir en la contabilidad.