Ledger CLI MCP Server

mcp-server-ledger: MCP-сервер Ledger CLI

Обзор

Сервер Model Context Protocol для взаимодействия с Ledger CLI , мощной системой учета с двойной записью, доступной из командной строки. Этот сервер позволяет Large Language Models запрашивать и анализировать ваши финансовые данные через инструмент Ledger CLI.

Этот сервер MCP реализует функциональность Ledger CLI через стандартизированный интерфейс, что позволяет помощникам на основе искусственного интеллекта помогать вам с финансовой отчетностью, анализом бюджета и бухгалтерскими задачами.

Функции

Сервер предоставляет следующие инструменты, которые сопоставляются с командами Ledger CLI:

1. ledger_balance
   • Показывает остатки на счетах с мощными возможностями фильтрации
   • Входные данные: шаблон запроса, диапазоны дат, параметры отображения
   • Возврат: Форматированный отчет о балансе
2. ledger_register
   • Показывает регистр транзакций с подробной историей
   • Входные данные: шаблон запроса, диапазоны дат, параметры сортировки.
   • Возврат: Форматированный отчет о регистрации
3. ledger_accounts
   • Перечисляет все счета в файле бухгалтерской книги
   • Входные данные: необязательный шаблон запроса
   • Возвращает: Список соответствующих счетов
4. ledger_payees
   • Список всех получателей платежей по транзакциям
   • Входные данные: необязательный шаблон запроса
   • Возврат: Список соответствующих получателей платежей
5. ledger_commodities
   • Перечисляет все используемые товары (валюты)
   • Входные данные: необязательный шаблон запроса
   • Возврат: Список соответствующих товаров
6. ledger_print
   • Печатает транзакции в формате бухгалтерской книги
   • Входные данные: шаблон запроса, диапазоны дат
   • Возвраты: Форматированные записи в бухгалтерской книге
7. ledger_stats
   • Показывает статистику по файлу бухгалтерской книги
   • Входные данные: необязательный шаблон запроса
   • Возвраты: Статистическая сводка бухгалтерской книги
8. ledger_budget
   • Показывает анализ бюджета
   • Входные данные: шаблон запроса, диапазоны дат, отчетный период
   • Возврат: отчет по бюджету
9. ledger_raw_command
   • Выполняет необработанную команду Ledger CLI
   • Ввод: аргументы команды в виде списка строк
   • Возвращает: Вывод команды в виде текста.

Предпосылки

• Ledger CLI должен быть установлен и доступен в вашей PATH
• Действительный файл бухгалтерской книги с вашими финансовыми данными

Установка

Использование Docker (рекомендуется)

Вы также можете использовать образ Docker из репозитория minhyeoky/mcp-ledger:

Добавьте это в ваш claude_desktop_config.json :

Замените /path/to/your/ledger/file.ledger на фактический путь к файлу вашей бухгалтерской книги.

Установка через Smithery

Чтобы автоматически установить Ledger CLI MCP Server для Claude Desktop через Smithery :

Использование УФ

Самый простой способ установить и запустить этот сервер — с помощью uv :

Конфигурация

Серверу требуется путь к вашему файлу Ledger. Это можно сделать через:

• Переменная среды LEDGER_FILE
• Аргументы командной строки при запуске сервера

Использование с Claude Desktop

Добавьте это в ваш claude_desktop_config.json :

Примеры использования

После настройки вы сможете задавать своему помощнику с искусственным интеллектом вопросы о ваших финансовых данных:

• «Покажите мне мои расходы за последний месяц»
• «Какой у меня текущий баланс на всех счетах?»
• «Список всех транзакций с Amazon»
• «Сколько я потратил на продукты в 2023 году?»
• «Покажите мне исполнение моего бюджета за первый квартал»

Для получения информации ИИ будет использовать соответствующие команды Ledger CLI через сервер.

Отладка

Для более подробного локального тестирования:

Разработка

Этот сервер создан с использованием Model Context Protocol Python SDK . Для получения дополнительной информации о MCP и о том, как разрабатывать серверы MCP, см. официальную документацию .

Чтобы внести свой вклад в этот проект:

1. Клонировать репозиторий
2. Установить зависимости разработки
3. Внесите изменения
4. Тестирование с использованием инспектора MCP или путем интеграции с Claude Desktop

Соображения безопасности

Этот сервер запускает команды Ledger CLI на ваших финансовых данных. Хотя он включает базовую проверку для предотвращения инъекции команд, вам следует:

• Используйте только с проверенными клиентами.
• Будьте осторожны с тем, какие пути к файлам вы раскрываете
• Проверьте все команды перед выполнением.

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Вы можете свободно использовать, изменять и распространять его в соответствии с условиями лицензии.