mcp-server-ledger: A Ledger CLI MCP Server
Сервер для интеграции Ledger CLI с ИИ, позволяющий анализировать финансовые данные через запросы и отчёты.
Описание
Это MCP-сервер на Python для работы с Ledger CLI — мощной системой двойной бухгалтерии. Он предоставляет стандартизированный интерфейс для LLM, чтобы запрашивать балансы, транзакции, бюджеты и статистику. Ключевые особенности: инструменты для фильтрации, дат и команд Ledger; поддержка Docker и uv. Применения: финансовый анализ, отчётность, бюджетирование с помощью ИИ-ассистентов, упрощая accounting tasks.
Возможности
ledger_balance
Показывает балансы счетов с фильтрами по паттернам, датам и опциями отображения.
ledger_register
Выводит регистр транзакций с историей, сортировкой и фильтрами по датам.
ledger_accounts
Перечисляет все счета в файле ledger с опциональным фильтром.
ledger_payees
Список получателей из транзакций с фильтром по паттерну.
ledger_commodities
Перечисляет валюты (коммодити) с опциональным фильтром.
ledger_print
Печатает транзакции в формате ledger с фильтрами по датам.
ledger_stats
Статистика файла ledger с опциональным фильтром.
ledger_budget
Анализ бюджета с фильтрами по паттернам, датам и периодам.
ledger_raw_command
Выполнение произвольной команды Ledger CLI с выводом результата.
Установка
Предварительные требования: Установите Ledger CLI и подготовьте файл ledger.
Через Docker (рекомендуется):
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"
]
}
}
Через uv:
uv sync
Укажите LEDGER_FILE в .env или аргументах.
Через Smithery:
npx -y @smithery/cli install @minhyeoky/mcp-ledger --client claude