将 AI 代理引入本地 hledger 文件以进行对话式记账
hledger-mcp，由IiAtlas创建，是一个MCP服务器，连接AI助手与本地hledger账本文件，实现互动记账。它接受自然语言提示以查询余额、生成报告，并通过兼容MCP的客户端记录经过验证的日记条目。主要功能包括账户和层次查询以及标准财务报表。该工具面向使用纯文本会计的财务爱好者和AI工程师，想通过MCP代理（如Claude Desktop）获得对私有本地数据的对话访问。
它将日志文件作为MCP资源暴露以供代理浏览
服务器自动将本地hledger日志文件注册为MCP资源，以便MCP兼容的客户端可以在不手动挂载文件的情况下浏览账本内容。安装需要一个模型上下文协议主机环境、Node.js和在PATH中的hledger CLI。该软件包作为@iiatlas/hledger-mcp从npm安装，提供的.mcpb文件允许兼容的桌面导入该服务以便更快的设置。
报告和查询输出源自本地hledger引擎，保留账本逻辑
数值输出如资产负债表和收益表是通过调用已安装的hledger CLI生成的，因此报告的余额和层次结构遵循hledger的解析和发布规则。服务器还暴露账户结构查询和交易频率及账户活动的统计分析例程，支持基于账本派生数字的程序化审查和代理总结。
写入操作包括验证和预览控制以降低风险
该工具允许代理添加或替换日志条目，但包括控制以限制意外写入：'干运行'模式预览更改，' --read-only'选项阻止文件修改。写入尝试之前会运行验证检查，启用人机协作的工作流程，在提交条目到纯文本日志之前对候选发布进行审查。
它适合那些接受技术设置以换取本地控制的用户
该服务器专为与纯文本会计打交道的金融爱好者和AI工程师设计，支持对话式簿记工作流程，例如将收据交给代理进行处理。开发者专注于MCP工具和纯文本会计扩展，并且还制作了如hledger-formatter for VS Code等补充工具。该项目在纯文本会计社区内受到积极欢迎，因其读写集成。
适合技术导向的纯文本会计用户的实用集成工具
当您需要代理驱动的访问现有 hledger 工作流时，请选择 hledger-mcp，并接受涉及 CLI 工具和 MCP 集成的设置。该服务器更奖励集成项目和自动化实验，而不是随意的开箱即用的记账；其设计适合优先考虑在代理工作流中可控的设备内账本交互的用户，而不是面向消费者的助手。
