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

👁 значок кузнеца

Обзор

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

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

Related MCP server: Lunch Money MCP Server

Функции

Сервер предоставляет следующие инструменты, которые сопоставляются с командами 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:

docker pull minhyeoky/mcp-ledger

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

"mcp-ledger": {
 "command": "docker",
 "args": [
 "run",
 "-v",
 "/path/to/your/ledger/file.ledger:/main.ledger",
 "-e",
 "LEDGER_FILE=/main.ledger",
 "-i",
 "--rm",
 "minhyeoky/mcp-ledger"
 ]
}

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

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

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

npx -y @smithery/cli install @minhyeoky/mcp-ledger --client claude

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

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

uv sync

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

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

• Переменная среды LEDGER_FILE

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

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

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

"mcpServers": {
 "ledger": {
 "command": "uv",
 "args": [
 "run",
 "--env-file",
 "/path/to/your/.env", // Optional: to set LEDGER_FILE
 "--with",
 "mcp[cli]",
 "mcp",
 "run",
 "<repo_path>/main.py" // Path to the main.py file in this repository
 ]
 }

}

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

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

• «Покажите мне мои расходы за последний месяц»

• «Какой у меня текущий баланс на всех счетах?»

• «Список всех транзакций с Amazon»

• «Сколько я потратил на продукты в 2023 году?»

• «Покажите мне исполнение моего бюджета за первый квартал»

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

Отладка

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

mcp dev main.py

Разработка

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

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

1. Клонировать репозиторий

2. Установить зависимости разработки

3. Внесите изменения

4. Тестирование с использованием инспектора MCP или путем интеграции с Claude Desktop

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

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

• Используйте только с проверенными клиентами.

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

• Проверьте все команды перед выполнением.

Лицензия

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

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• ledger_accountsC
• ledger_balanceD
• ledger_budgetD
• ledger_commoditiesC
• ledger_payeesC
• ledger_printC
• ledger_raw_commandD
• ledger_registerD