Ledger MCP Server — это MCP-сервер, который соединяет AI-ассистентов с системой учета Ledger CLI, позволяя LLM-агентам читать, анализировать и генерировать финансовые отчеты напрямую из текстовых журналов транзакций с помощью команд на естественном языке.
Ключевые особенности:
Чтение и анализ финансовых журналов: Инструменты get_balance и get_register позволяют AI-ассистенту мгновенно получать текущий баланс по любому счету и детальную историю транзакций с гибкой фильтрацией по периоду, что заменяет ручной просмотр текстовых файлов.
Генерация стандартных финансовых отчетов: Инструменты get_net_worth, get_income_statement и get_budget_report превращают сырые данные из Ledger CLI в готовые отчеты о капитале, доходах/расходах и исполнении бюджета прямо в чате.
Визуализация денежных потоков: Инструмент get_cashflow агрегирует и представляет данные о движении денежных средств, позволяя AI-модели быстро оценить ликвидность и направления трат пользователя.
Контекстная справка по синтаксису: Инструмент get_ledger_docs служит встроенным экспертом по командам Ledger CLI, позволяя AI-ассистенту отвечать на вопросы о форматировании и синтаксисе файлов учета без обращения к внешней документации.
Безопасность и конфиденциальность: Все финансовые данные остаются исключительно на локальной машине пользователя. Сервер работает напрямую с файлами .ledger (или .dat) и требует для доступа только путь к ним в конфигурации.
Для кого: Ориентирован на индивидуальных пользователей, фрилансеров и владельцев малого бизнеса, которые ведут учет личных или корпоративных финансов с помощью системы Ledger CLI и хотят взаимодействовать со своими данными через удобный диалоговый AI-интерфейс. Идеально подходит для тех, кто ценит контроль над данными, предпочитает текстовые форматы учета и хочет получать мгновенную аналитику без сложных SQL-запросов.
Сценарии использования:
Диалоговый анализ баланса: Пользователь спрашивает Claude: «Какой у меня баланс на кредитной карте и расчетном счете?», и сервер через get_balance мгновенно возвращает актуальные цифры из локального файла учета.
Мгновенный отчет о прибылях и убытках: В конце месяца фрилансер запрашивает: «Покажи мой отчет о доходах и расходах за прошлый квартал», и AI-ассистент через get_income_statement формирует структурированный P&L.
Контроль бюджета в реальном времени: Пользователь просит: «Сравни мои расходы на питание с бюджетом за этот месяц», и сервер с помощью get_budget_report показывает процент выполнения и области перерасхода.
Аудит денежных потоков: Предприниматель запрашивает у AI: «Покажи, куда уходили мои деньги в этом году», и сервер через get_cashflow предоставляет агрегированные данные для быстрой оценки финансового здоровья.
Цены и доступность: Сам MCP-сервер является опенсорсным (лицензия MIT) и распространяется бесплатно. Для работы требуется установленный Python 3.10+ и скомпилированный исполняемый файл Ledger CLI, а также наличие локального файла учета в формате Ledger. Установка осуществляется клонированием репозитория и запуском через uv или Docker, а конфигурация задается указанием пути к файлу данных в claude_desktop_config.json.
