hledger-mcp

Traer agentes de IA a archivos hledger locales para contabilidad conversacional

hledger-mcp, creado por IiAtlas, es un servidor MCP que conecta asistentes de IA a archivos de libro mayor hledger locales para contabilidad interactiva. Acepta solicitudes en lenguaje natural para consultar saldos, producir informes y registrar entradas de diario validadas a través de clientes compatibles con MCP. Las funciones clave incluyen consultas de cuentas y jerárquicas, además de estados financieros estándar. La herramienta está dirigida a entusiastas de las finanzas e ingenieros de IA que utilizan contabilidad en texto plano y que desean acceso conversacional a datos locales privados a través de agentes MCP como Claude Desktop.

Expone archivos de diario como recursos MCP para la navegación de agentes

El servidor registra automáticamente archivos de diario hledger locales como recursos MCP para que los clientes compatibles con MCP puedan navegar por el contenido del libro mayor sin necesidad de montar archivos manualmente. La instalación requiere un entorno de host del Protocolo de Contexto de Modelo, Node.js y el CLI de hledger en PATH. El paquete se instala desde npm como @iiatlas/hledger-mcp, y el archivo .mcpb proporcionado permite a los escritorios compatibles importar el servicio para una configuración más rápida.

Los informes y las salidas de consultas provienen del motor hledger local, preservando la lógica del libro mayor

Las salidas numéricas como los balances y los estados de resultados se generan invocando el CLI de hledger instalado, por lo que los saldos e jerarquías reportados siguen las reglas de análisis y publicación de hledger. El servidor también expone consultas sobre la estructura de cuentas y rutinas de análisis estadístico para la frecuencia de transacciones y la actividad de cuentas, lo que apoya la revisión programática y la resumación de agentes basada en cifras derivadas del libro mayor.

Las operaciones de escritura incluyen controles de validación y vista previa para reducir riesgos

La herramienta permite a los agentes agregar o reemplazar entradas de diario, pero incluye controles para limitar escrituras accidentales: un modo de 'prueba en seco' muestra cambios y una opción '--solo-lectura' bloquea la modificación de archivos. Las verificaciones de validación se ejecutan antes de los intentos de escritura, habilitando un flujo de trabajo con un humano en el bucle donde las publicaciones candidatas se revisan antes de comprometer las entradas al diario de texto plano.

Se adapta a usuarios que aceptan una configuración técnica a cambio de control local

Diseñado para entusiastas financieros e ingenieros de IA que trabajan con contabilidad en texto plano, el servidor admite flujos de trabajo de contabilidad conversacional, como entregar recibos a un agente para su procesamiento. El desarrollador se centra en herramientas MCP y extensiones de contabilidad en texto plano y también produce herramientas complementarias como hledger-formatter para VS Code. El proyecto recibe una recepción positiva dentro de la comunidad de contabilidad en texto plano por su integración de lectura/escritura.

Herramienta de integración práctica para usuarios de contabilidad en texto plano con mentalidad técnica

Elige hledger-mcp cuando necesites acceso impulsado por agentes a flujos de trabajo existentes de hledger y aceptes una configuración que implique herramientas de línea de comandos e integración de MCP. El servidor recompensa los proyectos de integración y los experimentos de automatización más que la contabilidad casual y lista para usar; su diseño se adapta a los usuarios que priorizan interacciones controlables con el libro mayor en el dispositivo dentro de flujos de trabajo de agentes en lugar de asistentes listos para el consumidor.