Beanquery MCP
позволяет AI-ассистентам запрашивать и анализировать финансовые ledger Beancount с помощью BQL
Описание
Это экспериментальный сервер на основе Model Context Protocol (MCP), который интегрирует AI-ассистентов (например, Claude) с файлами Beancount для финансового анализа. Использует Beancount Query Language (BQL) и инструмент beanquery для выполнения запросов к ledger-файлам. Ключевые особенности: установка ledger, запуск BQL-запросов, доступ к таблицам и аккаунтам. Технологии: Python 3.10+, Beancount, beanquery. Применения: автоматизированный анализ финансовых данных в AI, с предупреждением о приватности.
Возможности
Установка ledger файла
Задаёт Beancount ledger файл для последующих запросов (через инструмент set_ledger_file или переменную BEANCOUNT_LEDGER).
Запуск BQL-запросов
Выполняет запросы на языке Beancount Query Language против загруженного ledger для анализа финансовых данных (инструмент run_query).
Список таблиц
Предоставляет доступ к списку таблиц, доступных в BQL (ресурс beanquery://tables).
Список аккаунтов
Возвращает список аккаунтов из ledger файла (ресурс beanquery://accounts).
Установка
Предварительные требования: Python 3.10 или выше, uv для управления проектами.
Для разработки: mcp dev server.py
Для установки в Claude Desktop: uv run mcp install server.py –with beancount –with beanquery
С переменной окружения: uv run mcp install server.py -v BEANCOUNT_LEDGER=/path/to/ledger.bean –with beancount –with beanquery
Тестирование: pytest server_test.py