hledger-mcp

Breng AI-agenten naar lokale hledger-bestanden voor conversatie boekhouding

hledger-mcp, gemaakt door IiAtlas, is een MCP-server die AI-assistenten verbindt met lokale hledger-boekhoudbestanden voor interactieve boekhouding. Het accepteert natuurlijke taal prompts om saldi op te vragen, rapporten te produceren en gevalideerde journaalboekingen vast te leggen via MCP-compatibele clients. Belangrijke functies zijn onder andere account- en hiërarchische queries plus standaard financiële overzichten. De tool richt zich op financiële enthousiastelingen en AI-ingenieurs die platte tekst boekhouding gebruiken en conversatie toegang willen tot privé lokale gegevens via MCP-agenten zoals Claude Desktop.

Het stelt journaalbestanden bloot als MCP-bronnen voor agentenbrowsing

De server registreert automatisch lokale hledger journaalbestanden als MCP-bronnen, zodat MCP-compatibele clients de inhoud van het grootboek kunnen doorbladeren zonder handmatig bestanden te monteren. Installatie vereist een Model Context Protocol hostomgeving, Node.js en de hledger CLI in PATH. Het pakket wordt geïnstalleerd vanuit npm als @iiatlas/hledger-mcp, en het meegeleverde .mcpb-bestand stelt compatibele desktops in staat om de service te importeren voor snellere installatie.

Rapporten en query-uitvoeren komen van de lokale hledger-engine, waarbij de logica van het grootboek behouden blijft

Numerieke uitvoer zoals Balans en Resultatenrekening worden gegenereerd door de geïnstalleerde hledger CLI aan te roepen, zodat gerapporteerde saldi en hiërarchieën de parserings- en boekingsregels van hledger volgen. De server stelt ook accountstructuurqueries en statistische analysemethoden voor transactiefrequentie en accountactiviteit bloot, wat programmatic review en agentensamenvattingen op basis van grootboekafgeleide cijfers ondersteunt.

Schrijfbewerkingen omvatten validatie en previewcontroles om risico's te verminderen

De tool staat agenten toe om journaalitems toe te voegen of te vervangen, maar bevat controles om onopzettelijke schrijfbewerkingen te beperken: een 'dry-run' modus geeft een preview van wijzigingen en een '--read-only' optie blokkeert bestandswijzigingen. Validatiecontroles worden uitgevoerd voordat schrijfproberen worden gedaan, waardoor een human-in-the-loop workflow mogelijk is waarbij kandidaatboekingen worden beoordeeld voordat ze aan het platte tekstjournaal worden toegevoegd.

Het past bij gebruikers die een technische setup accepteren in ruil voor lokale controle

Ontworpen voor financiële enthousiastelingen en AI-ingenieurs die met platte tekst boekhouding werken, ondersteunt de server conversatieboekhoudworkflows zoals het overhandigen van bonnetjes aan een agent voor verwerking. De ontwikkelaar richt zich op MCP-tools en platte tekst boekhouduitbreidingen en produceert ook aanvullende tools zoals hledger-formatter voor VS Code. Het project krijgt positieve reacties binnen de platte tekst boekhouding gemeenschap voor zijn read/write-integratie.

Praktische integratietool voor technisch onderlegde gebruikers van platte tekst boekhouding

Kies hledger-mcp wanneer je agent-gedreven toegang nodig hebt tot bestaande hledger-workflows en accepteer een setup die CLI-tools en MCP-integratie omvat. De server beloont integratieprojecten en automatiseringsexperimenten meer dan casual, kant-en-klare boekhouding; het ontwerp is geschikt voor gebruikers die controleerbare, op het apparaat gebaseerde grootboekinteracties binnen agentworkflows prioriteren boven consumentgerichte assistenten.